# Troubleshooting

This page collects problems that can come up anywhere in Productmind, with their causes and
fixes. Each chapter of this guide also ends with the problems specific to its page.

## Signing in

### "Invalid email or password"

Check the email address and the password. To choose a new password, on the sign-in page choose
**Forgot your password?** and follow the link in the email Productmind sends you. See
[Signing up and signing in](/user-guide/get-started/sign-up-and-sign-in).

### "Your organization requires single sign-on"

Your organization lets its members sign in only through its identity provider. Choose
**Continue with SSO** and sign in there. The organization's owner can still use a password. See
[Single sign-on](/user-guide/settings/identity-and-access/single-sign-on).

### "You signed in through ... single sign-on, which opens ... only"

You signed in through an organization's single sign-on, and tried to switch to another
organization or to connect an app to one. That sign-in opens only its own organization. Sign out,
then sign in again the way the message says: with your password or Google, or through the other
organization's own single sign-on. See
[Organizations and workspaces](/user-guide/get-started/organizations-and-workspaces#if-you-signed-in-with-single-sign-on).

### I lost my authenticator app

When Productmind asks for the code, choose **Use a recovery code instead**, and enter one of the
recovery codes you saved when you set up multi-factor authentication. Each code works once. If
you have none left, contact Productmind support. See
[Multi-factor](/user-guide/settings/identity-and-access/multi-factor).

### "Your organization has been suspended. Contact `support@productmind.ai`."

Your organization is suspended, so its members can't use Productmind. Write to
support@productmind.ai to find out more, or to restore access.

Your organization's owner gets an email when the organization is suspended, and another when
access is restored.

### I was signed out, or a tool stopped working

Someone revoked the session, or it expired. Sign in again. To see and end the browsers, devices
and tools signed in to your account, choose your avatar at the bottom of the sidebar, then
**Profile**, and look under **Connected clients**. See
[Profile and notifications](/user-guide/profile-and-notifications#connected-clients).

## Missing menu items and buttons

### A menu item, tab or button is missing

When a menu item, a tab or a button you expect isn't there, it is one of three things. A feature
your plan doesn't include is never missing: it shows a lock instead. See
[A menu item, tab or button shows a lock](#a-menu-item-tab-or-button-shows-a-lock).

**Your role doesn't allow it.** Productmind hides what your role can't do: a menu item needs
permission to read that kind of record, and a **Create** or **Delete** button needs permission to
create or delete it. Each page of this guide says what it needs in its **Availability** block.
Find your role in [Roles and permissions](/user-guide/reference/roles-and-permissions), and ask an
Owner or Admin if you need more. These menu items are for the **Owner** and **Admin** roles only:
**Settings**, **Integrations**, **Identity & Access** and **Billing & Payments**. Every role can
still open [Integrations](/user-guide/settings/integrations) from its icon at the top-right of the
page, to connect their own accounts.

**The feature is being rolled out.** Some features are enabled one organization at a time. If
one isn't enabled for yours, it doesn't appear at all, whatever your role. They are:
- [Automations](/user-guide/engineering/automations), and the **Definitions** tab of
  [Agents](/user-guide/engineering/agents/definitions);
- [Internal meetings](/user-guide/internal-meetings);
- [Productmind reviews](/user-guide/help-and-support#asking-for-a-review), and the
  [Support access](/user-guide/settings/identity-and-access/support-access) tab. Asking the
  assistant in the **Support center**, and opening a question, bug report or feature request,
  aren't part of the rollout;
- automated ingestion of new tickets from your helpdesk. See
  [Freshdesk and Zendesk](/user-guide/settings/freshdesk-and-zendesk);
- creating more than one workspace. See
  [Organizations and workspaces](/user-guide/get-started/organizations-and-workspaces#creating-a-workspace).

A page about one of these says **Rollout** in its **Availability** block. Ask Productmind
support to turn it on.

**You're in another workspace.** Most of what you see belongs to the workspace you're in. The
workspace switcher at the bottom of the sidebar shows which one that is, and lets you change it.
If it isn't there, you have only one workspace.

### A menu item, tab or button shows a lock

Your organization's plan doesn't include that feature. It stays where it is, and opening it shows
a page or a dialog naming the plan that includes it. **Decision records**, for example, are part
of the **Enterprise** plan. An Owner or Admin can change the plan. See
[Features that depend on your plan](/user-guide/reference/plans-and-limits#features-that-depend-on-your-plan).

A plan can also leave out coding sessions, live previews or interviews. Those don't show a lock:
Productmind tells you when you try to use one. See
[Plans and limits](/user-guide/reference/plans-and-limits).

## Workspaces and invitations

### A colleague can't see a workspace

Members who aren't Owners or Admins use only the workspaces they have been given. An Owner or
Admin can give them more on **Identity & Access › Users**: choose the member's workspaces and
select the ones they need. See [Users](/user-guide/settings/identity-and-access/users).

If the colleague is an Owner or Admin, the workspace was created after they joined, and only its
creator has access at first. See
[Organizations and workspaces](/user-guide/get-started/organizations-and-workspaces#i-cant-see-a-workspace-my-team-uses).

### An invitation didn't arrive, or has expired

An invitation works for 7 days. Ask an Owner or Admin to resend it from the **Users** tab: the
new email has a fresh link. Check your spam folder too.

### "An invitation is already pending for this email"

The person already has an invitation, which may have expired. Resend or revoke it from their
row on the **Users** tab.

### "You have reached your user limit"

Every seat on your plan is taken. Active members and pending invitations each take one. Revoke
invitations nobody will accept, disable members who have left, or move to a plan with more
users. See [Plans and limits](/user-guide/reference/plans-and-limits).

## Sessions

### A session won't launch for a task

The task is already in another session that is working on it. Open that session from the badge
in the task's header, or wait for it to finish. See [Tasks](/user-guide/tasks).

### Where do I download the Productmind agent?

There is no installer file to download. The Productmind agent, also called the local agent, is the
`pm agent` command of the Productmind CLI, which you install with a few commands in a terminal: with
Homebrew on macOS, with apt or dnf on Linux, inside WSL 2 on Windows, or with the install script.
In Productmind, choose your avatar at the bottom of the sidebar, then **Connect your Productmind
agent**: it shows the commands for your system, each with a copy button. Everyone with **Agents**
access (the Owner, Admin, Power User and Developer roles) also finds them in
**Agents > Productmind CLI**. See
[Installing the CLI](/user-guide/tools/productmind-cli#installing-the-cli).

### My machine isn't offered when I build a session

The Productmind agent isn't running on it, or it is signed in to another organization. Run
`pm agent`, and check `pm whoami`. See [Productmind CLI](/user-guide/tools/productmind-cli).

### "Productmind cloud sessions are turned off for this workspace"

Your workspace runs sessions, live previews, scans and feature discovery only on Productmind
agents, and the agent the work needs isn't online. Start it with `pm agent`, or choose **Connect
your Productmind agent** for the steps, then try again. See
[Settings > Coding sessions](/user-guide/settings/workspace-settings/coding-sessions#troubleshooting).

### A session is waiting

A number on **Code** in the sidebar counts the sessions that need your input, for example a
plan to approve or a question to answer. Open the session to answer. See
[Working in a session](/user-guide/sessions/working-in-a-session).

### A session says "Waiting for a runner"

Every session that builds on the cloud runs on a runner of its own, and none was free yet. The
run starts by itself as soon as one is, and a run that waits more than 15 minutes stops with **No
runner became available for this session in time. Retry in a few minutes.** Choose **Retry** then.
See
[Working in a session](/user-guide/sessions/working-in-a-session#how-a-running-session-behaves).

### A session's run failed

The session says the error the run stopped on, why, and what to do, above **Retry** and **Cancel
session**. Choose **View details** to read the error's output in the session's **Errors** tab. See
[Reading the session's errors](/user-guide/sessions/working-in-a-session#reading-the-sessions-errors).

### A session says "Agent offline"

The machine running the session's agent went away in the middle of a run. When it's the Productmind
agent on your own machine, start `pm agent` there again and the session continues where it left
off. A cloud session continues on a new runner by itself. To stop waiting, choose **Cancel
session**. See
[Working in a session](/user-guide/sessions/working-in-a-session#how-a-running-session-behaves).

### The agent stopped responding

When the agent hasn't reported for 5 minutes, the session shows a warning with what it knows: how
long the agent has been silent, whether its cloud runner or your own Productmind agent is still
alive, and the last step it reported. Choose **Restart run** to start the same run again from where
it was saved, or **Cancel session** to end it. If your own agent is shown as not connected, start
`pm agent` on that machine and the run continues where it left off. See
[To restart a run that stopped responding](/user-guide/sessions/stopping-and-restarting#to-restart-a-run-that-stopped-responding).

### A cancelled session only offers "Draft a new plan"

**Resume session** shows only when a cancelled session has something to go back to: a pull request
that is still open, or the build of an approved plan that hadn't opened its pull request yet. When
every pull request was closed or merged, reopen a closed one to put the session back **PR Ready for Review**.
When the plan changed after you approved it, draft a new plan and approve it again. See
[To resume a cancelled session](/user-guide/sessions/stopping-and-restarting#to-resume-a-cancelled-session).

## The PM agent

### "This turn could not be saved, so the assistant will not remember it"

Productmind couldn't save this exchange to the assistant's memory. The reply is complete and stays
in the conversation, with this note under it, but the assistant won't remember your message or
its reply when you send the next one. If the assistant needs to remember them, send your message
again. See
[The PM agent](/user-guide/get-started/finding-your-way-around#the-pm-agent).

### "This approval is no longer pending"

The approval was already answered, for example in another browser tab, or the conversation has
moved on since. Nothing was run. Send a new message to carry on.

When you answer an approval, it closes in your other browser tabs too. So this message appears in
a tab that missed that update, for example because it lost its connection or your computer was
asleep, or when you answer in two places at almost the same moment.

If the message says the approval "has already been answered, so this answer was not applied", it
was answered a moment earlier from somewhere else, for example a second tab. Your answer was not
applied; the first one was.

If the message says the approval "can no longer be applied safely", nothing was run either. Send
your request again.

### My message came back as "Message not sent"

Productmind refused the message before sending it, so the assistant never got it and nothing was
charged. The card says why: your organization's Pay-as-you-go balance can't cover it,
pay-as-you-go isn't activated, spending is paused, a usage limit is reached, or your organization's
own model provider key can't be used. Your words, images and pinned records are back in the box.
Take the card's action, such as **Top up**, or ask an Owner or Admin to, then choose **Try
again**. For a daily, weekly or monthly limit, the card also says when the limit resets, and its
**View plans** opens **Usage limit reached** again. When no plan you can switch to raises the
limit, the card has no **View plans**: wait for the limit to reset, then choose **Try again**. See
[The PM agent](/user-guide/get-started/finding-your-way-around#the-pm-agent).

## Limits and usage

### "Usage limit reached"

Your organization reached a limit of its plan, and the message names it. For a daily, weekly or
monthly AI credit limit, the dialog also says when the limit resets, and offers the plans that
raise it, or **Contact us** when no plan you can switch to does. See
[Plans and limits](/user-guide/reference/plans-and-limits) for what each limit means and what you
can do.

### "Your Pay-as-you-go balance is ..., and ... needs at least ... available"

The work is paid from your Pay-as-you-go balance, and the balance doesn't cover it. The message
names your balance and what the work needs, for example "Your Pay-as-you-go balance is EUR 4.57,
and a coding step needs at least EUR 6.24 available. Top up to continue." An Owner or Admin
chooses **Top up** in the message: the top-up dialog opens with the amount that covers it already
entered. See [Usage](/user-guide/settings/billing-and-payments/usage#to-top-up-your-balance).

### "AI work is being refused"

Your Owners and Admins get this notice, in the app and by email, when billing refused work nobody
was watching: your feedback widget's reply to a visitor, an agentic interview, the indexing of a
knowledge base document, or an automation run that an event or a schedule started. It names what
was refused, why, and what fixes it: a top-up, activating pay-as-you-go, turning spending back on,
or, for a usage limit, a larger plan or waiting for the limit to reset. It is sent at most once a
day. See
[Billing notices](/user-guide/profile-and-notifications#billing-notices).

### A scan says "Paused: top up to continue"

Your balance ran out between the steps of a scan. Once a top-up settles, the scan continues by
itself. See [Applications](/user-guide/engineering/applications#if-a-scan-pauses).

## Scans

### The feature map says a repository "contributed no features"

The scan could not place any of that repository's entry points in a feature, so the map shows
nothing from it. Open the repository list under the feature map header to see why. Most often the
repository's install failed, for example because its packages come from a private registry. Add the
registry's token to the application or to your default sandbox, and an install command that uses
it, then scan again. See
[Applications](/user-guide/engineering/applications#to-install-from-a-private-package-registry).
To have the scan stop and say why when the install fails, turn on **Require dependencies to
install** for the application. See
[Applications](/user-guide/engineering/applications#to-require-the-dependencies-to-install).

### A scan's draft shows "... audit findings" and "... kept this draft from applying itself"

Productmind checked the specification the scan drafted, and found the problems that **Show details**
lists, one sentence each. A finding marked **blocking** kept the draft from applying itself, so it
waits for your review. It doesn't stop you from applying the draft. See
[Audit findings](/user-guide/product/audit-findings) for what each finding means and what to do
about it.

## Integrations and tools

### An integration says "This connection needs re-authorising"

The other service stopped accepting Productmind's access, for example because a password
changed or access was revoked there. Reconnect it from its page under **Integrations**. See
[Integrations](/user-guide/settings/integrations).

### An AI assistant can't find my workspace

It is signed in to another organization. Sign it in again and choose the right one. See
[AI assistants (MCP)](/user-guide/tools/ai-assistants).

### The feedback widget doesn't appear on my site

See [Feedback widget](/user-guide/tools/feedback-widget#troubleshooting).

## Getting more help

On any page, choose **Support center** (the question mark icon) at the top-right. Ask the
assistant, which answers from this guide and the API reference, or choose **New support request**
(the **+** button) to ask the Productmind team. See [Support center](/user-guide/help-and-support).

## Related topics

- [Roles and permissions](/user-guide/reference/roles-and-permissions)
- [Plans and limits](/user-guide/reference/plans-and-limits)
- [Glossary](/user-guide/reference/glossary)
