Reference

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.

"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.

"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.

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.

"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.

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.

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, 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 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:

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.

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.

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.

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.

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.

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.

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.

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.

"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.

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.

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.

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.

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.

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.

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.

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.

"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.

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 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.

"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.

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.

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. To have the scan stop and say why when the install fails, turn on Require dependencies to install for the application. See Applications.

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 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.

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).

The feedback widget doesn't appear on my site

See Feedback widget.

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.

Last modified on