Plandex
Plandex is an open-source, terminal-based AI coding agent designed to take on large, multi-step software development tasks across many files in real world codebases. Written in Go and released under the MIT license, Plandex builds and executes long-running "plans" — durable, branchable units of work that combine intelligent context management, project maps generated with tree-sitter for 30+ programming languages, an effective 2M-token context window, and a cumulative diff review sandbox that isolates AI edits until a developer explicitly applies them. The tool ships as a CLI with an interactive REPL (fuzzy auto-complete), supports automated debugging of terminal commands and browser applications, integrates with Git for branching and commit-message generation, and is provider-neutral — working with Anthropic Claude, OpenAI, Google Gemini, OpenRouter.ai, Azure OpenAI, AWS Bedrock, DeepSeek, Perplexity, Ollama, and any OpenAI-compatible custom provider. The Plandex Server exposes a REST management/orchestration API (over 60 endpoints across accounts, orgs, projects, plans, branches, context, conversation, diffs, settings, model packs, and streaming execution) that powers both the CLI/REPL and the hosted Plandex Cloud. Plandex Cloud is winding down as of 2025-10-03; Plandex is now distributed primarily as a Docker-based self-hosted / local-mode product that users run with their own model-provider API keys.
APIs
Plandex Server API
Management and orchestration REST API exposed by the Plandex server (open-source, Go) used by the Plandex CLI/REPL to drive long-running coding plans across organizations, proje...
Collections
Plandex Server API
OPENPricing Plans
Rate Limits
FinOps
Plandex Finops
FINOPSFeatures
Smart context management loads only what's needed per step, enabling reliable work in large projects and files.
Fast project map generation and syntax validation across 30+ programming languages. Indexes directories with 20M+ tokens.
AI-generated changes are isolated from project files until explicitly applied, with cumulative review and roll-back.
Five autonomy levels — None, Basic, Plus, Semi-Auto, Full-Auto — selectable per-plan or via CLI flags.
Repeatedly runs commands (builds, tests, lints, scripts) and auto-fixes failures with rollback. Also debugs browser apps via Chrome.
Curated combinations of models bound to internal roles (planner, coder, builder, summarizer, verifier, context loader); built-in packs for daily, reasoning, strong, cheap, oss, and planner-specialized variants.
First-class support for Anthropic, OpenAI, Google AI Studio, Google Vertex AI, Azure OpenAI, AWS Bedrock, DeepSeek, Perplexity, OpenRouter, Ollama, and any OpenAI-compatible custom provider.
Plandex can use a Claude Pro or Max subscription as the credential when calling Anthropic models.
Built-in context caching across OpenAI, Anthropic, and Google models reduces latency and cost on multi-step plans.
Every plan update is versioned, with branching for exploring multiple paths or comparing different models. Rewind to any prior SHA.
Commit message generation, optional auto-commits, and clean integration with project git history.
Interactive shell launched by `plandex` (or `pdx`) with fuzzy command and file completion; backslash equivalents (`\new`, `\tell`) for every command.
Zero-dependency CLI install via `curl -sL https://plandex.ai/install.sh | bash`. Docker compose for the self-hosted server.
`--bg` flag runs plans concurrently in the background under separate streams.
Loads only the files needed for each implementation step (smart-context) and uses the project map to choose them (auto-load-context).
tell, build, and connect endpoints stream model responses live; clients can reconnect to in-progress plans after disconnects.
Use Cases
Coordinate refactors that touch dozens of files across a large codebase without losing the thread between steps.
Work in repositories that span 30+ languages thanks to tree-sitter project maps.
Take a feature from idea through chat mode, into a detailed implementation plan, into reviewed and applied file changes.
Wrap a flaky build, test, or browser app in `plandex debug` and let Plandex iteratively repair it.
Use chat mode and the project map to ask questions about an unfamiliar codebase.
Branch a plan to run different model packs against the same context and compare results.
Kick off `--bg` plans, switch repos, and reconnect to streaming output later.
Use a Claude Pro/Max subscription as the credential for an autonomous coding agent.
Run the Plandex server in Docker on-prem with locally-hosted Ollama models or a private custom provider.
Integrations
Direct Anthropic API integration; also supports Claude Pro/Max subscriptions.
Direct OpenAI API integration via OPENAI_API_KEY.
Default recommended provider for self-hosted Plandex; also used as a failover route across other configured providers.
Gemini models via GEMINI_API_KEY.
Gemini and Anthropic models via Vertex AI credentials.
OpenAI models on Azure with deployment-name mapping.
Anthropic models on Bedrock with AWS profile or env-var credentials.
DeepSeek models via DEEPSEEK_API_KEY.
Perplexity models via PERPLEXITY_API_KEY.
Local model hosting via Ollama; no API keys required.
Any OpenAI-compatible API can be added via a JSON config (`plandex models custom`).
Instant-apply fallback model used when Plandex cannot apply edits deterministically (Plandex Cloud).
Branching, commit-message generation, optional auto-commits.
Automated debugging of browser applications when Chrome is installed.
Self-hosted server distributed as a Docker image with a published docker-compose stack.
Backing database for the Plandex server.
Embedded LiteLLM proxy used by the server to talk to model providers uniformly.
Payment processing for Plandex Cloud subscriptions and credit purchases.
Email marketing for Plandex updates (Plandex Cloud).
Basic usage analytics (Plandex Cloud).
Error tracking (Plandex Cloud).
Solutions
Run Plandex locally with Docker and BYO model-provider keys. MIT-licensed and free.
Hosted Plandex with user-supplied provider keys, $30/month after trial. Winding down 2025-10-03.
Hosted Plandex with integrated credit billing, $45/month including $20/mo of non-expiring credits. Winding down 2025-10-03.