PlanBefore
HomeDownloadInstallReleasesGitHub

Let your AI read the whole codebase before it plans a change.

PlanBefore gives ChatGPT and other MCP clients read-only access to the projects you choose, on your machine. They analyze and propose a plan; you execute it with your own tools. Your repository never leaves your computer.

DownloadmacOS, Linux and WindowsInstallation guide
curl -fsSL https://planbefore.kvnlabs.xyz/install.sh | sh

Latest release v0.3.0 — No Go toolchain required.

Analyze

ChatGPT reads src/auth/session.go and its Git history. Read-only.

Plan

Proposes: rotate refresh tokens on reuse. 3 files, 2 steps. No change made.

Execute

You apply the plan on your machine, with your own tools.

Your AI client asks. Your machine answers, read-only.

The Node runs next to your code and keeps an outbound connection to the Hub. Your MCP client talks to the Hub, which routes each request to your Node.

  1. Your machine

    PlanBefore Node

    Serves only the projects you exposed and only read operations. Files are read locally, one request at a time.

  2. PlanBefore Hub

    mcp.kvnlabs.xyz/repoflow

    Receives MCP requests and routes each one to the Node that owns the project.

  3. Your AI client

    ChatGPT or another MCP client

    Lists your projects, browses the tree, searches code, reads files and inspects Git history.

Built for developers who want AI help without handing over the repository

  • Read-only

    The MCP tools list, browse, search and read: projects, files, code search and Git history. None of them modify your repository or run arbitrary commands.

  • Local-first

    Your repository stays on your machine: it is never uploaded or mirrored. Files are read locally, on demand, only when an authorized MCP client asks for them.

  • Explicit project access

    Only the folders you expose with pbnode expose are reachable. The rest of your disk is not, and files such as .env, private keys and credentials are excluded by default.

  • Multi-platform

    Native builds for macOS (Apple Silicon and Intel), Linux and Windows (x86_64 and ARM64). No Go toolchain required.

  • Works with MCP clients

    Works with MCP clients that support remote servers with OAuth authorization, such as ChatGPT. Point them at one endpoint.

  • Secure Node identity

    Each Node has its own cryptographic key, kept in your system credential store, and is approved from your account with a passkey. You can revoke it from your account at any time.

Your repository stays on your machine.

PlanBefore never uploads or mirrors your repository. Files and code are read locally, on demand. Only the content an authorized MCP client explicitly requests — a file, search results, a diff — is returned to that client, for that request.

  • Read-only MCP interface. The Node exposes listing, search and read operations — nothing that writes.
  • Local restrictions on every request. Paths must stay inside the project, sensitive files are excluded and file sizes are limited.
  • Only what you enable. Projects are shared only after you expose them, and you can revoke them at any time.

That returned content is what the AI client uses to answer you, so expose only projects you are comfortable sharing with the AI tools you connect.

Install in one command

The installer downloads the right build from GitHub Releases, verifies its SHA-256 checksum and installs pbnode for your user.

macOS / Linux (Terminal)

curl -fsSL https://planbefore.kvnlabs.xyz/install.sh | sh

Windows (PowerShell)

irm https://planbefore.kvnlabs.xyz/install.ps1 | iex

Prefer to do it by hand? The manual installation takes five steps.

Then connect your first project

pbnode init
pbnode login
pbnode expose ~/Projects/my-project
pbnode serve --background
pbnode status

pbnode login opens the approval page on PlanBefore Auth; the terminal never asks for your credentials.

Read the installation guide