Support

Answers to the most common problems, and how to reach us when they are not enough.

Installation

The installation guide covers macOS, Linux and Windows step by step. PlanBefore Node only needs git and rg (ripgrep). To check the installed binary:

pbnode version

If your terminal can’t find pbnode, see the troubleshooting section. PlanBefore accounts are created by invitation: without an account you can’t authorize a Node or an assistant.

Connect your AI assistant

Add PlanBefore to ChatGPT, Claude, Gemini, or another compatible assistant with this MCP server URL, and authorize access with your PlanBefore account:

https://mcp.kvnlabs.xyz/repoflow

• The assistant only sees the projects you exposed with the same account that authorized the Node.
• If authorization fails or expires, disconnect PlanBefore in your assistant’s app or connector settings and connect it again.
• To write planning documents, the project needs an authorized folder (pbnode expose . --spec-root specs). Task execution with your local development agent is enabled separately.

Your Node shows as offline

If the assistant can’t find your projects or reports that the Node is not connected:

1. Check the state of the Node and its projects:

   pbnode status
   pbnode projects

   Copy
2. If the service isn’t running, start it in the background:

   pbnode serve --background

   Copy
3. Your machine must be on, awake and online: while it sleeps, its projects are unavailable until the Node reconnects.
4. After updating PlanBefore, restart the Node with pbnode stop and pbnode serve --background.
5. If you revoked this Node from your account, it can no longer connect with that identity. Contact us if you need help authorizing a new Node.

Revoke access

• An AI assistant: disconnect PlanBefore in that assistant’s app or connector settings. From then on it can’t make new requests with that authorization.
• A project: stop exposing it with pbnode revoke <project-id> (use pbnode projects to see the identifier).
• A machine (Node): revoke it in your PlanBefore account. A revoked Node is disconnected and can’t be used again.
• A passkey: remove it in your PlanBefore account. If you lost all your passkeys, use a recovery code from the sign-in page.

Delete your account

Email privacy@kvnlabs.xyz from a channel that lets us verify the account is yours, and include your username. We first disable the account, end its sessions and revoke its authorizations and Nodes; then we delete persistent information as described in the Privacy Policy. Your repository is never stored by PlanBefore, so there is nothing of it to delete from our servers.

Contact

• Support, account and privacy: privacy@kvnlabs.xyz
• PlanBefore Node bugs: GitHub Issues. They are public: don’t include code, private paths, tokens or other secrets.

Include your operating system, the output of pbnode version and the assistant you use. We will never ask for your passkey, your recovery codes or the contents of your repository.