# Plandex | Artificialus > For the complete content index, see [llms.txt](https://artificialus.com/llms.txt). Markdown versions of all pages are available by appending `.md` to any URL. - Home - / - Agents - / - Plandex PL # Plandex AI coding in your terminal for large, real-world tasks. Plandex AI Open source Since 2024 Visit Website Repository Docs Download Share X Facebook Reddit Telegram Bluesky Email Plandex is an open-source, terminal-based AI coding agent built for large, complex tasks that span many files and require multiple steps. It uses a protected sandbox with cumulative diff review so changes never touch your project until you explicitly approve them. With support for up to 2M tokens of effective context, tree-sitter project maps covering 30+ languages, and configurable autonomy from full auto-mode to step-by-step control, Plandex is designed for real-world projects of any scale. ## + Pros - Protected sandbox with cumulative diff review — changes never touch your repo until you explicitly approve - Purpose-built for large tasks — up to 2M token effective context window with intelligent file loading - Tree-sitter project maps — fast, syntax-validated maps for 30+ languages - Configurable autonomy — from full auto-mode to fine-grained step-by-step approval - Curated model packs — pre-configured combinations optimized for capability, cost, or speed - Provider-agnostic with automatic fallback — Claude, GPT, Gemini, Mistral, DeepSeek, Ollama, OpenRouter - MIT open source — fully self-hostable with no vendor dependency - Terminal-first — fits naturally into existing shell and git workflows with REPL mode and fuzzy auto-complete ## − Cons - Terminal-only — no IDE integration or GUI for developers who prefer visual environments - Requires manual context loading for very large monorepos — auto-loading has limits - Smaller community and ecosystem than Cline or Roo Code - Plandex Cloud winding down — new users must self-host via Docker or local mode ## Pricing ### Self-hosted/Local Free Open-source, self-hosted with Docker. Use your own API key. 2M token context window. ### Plandex Cloud Discontinued Winding down as of Oct 2025, no longer accepting new users. ## Introduction Plandex is an open-source AI coding agent that lives entirely in the terminal and handles large, multi-step tasks that touch many files. Where most agents edit files directly and leave you to sort out the aftermath, Plandex works in a protected sandbox: every change the agent proposes is accumulated as a pending diff and presented for review before anything is written to your actual project. This git-style approval flow makes it safe to run Plandex on major refactors, migrations, or feature additions that span dozens of files. Under the hood, Plandex combines tree-sitter project maps (supporting 30+ languages), a 2M token effective context window, and configurable autonomy — you can let it run fully unattended or approve every change step by step. It supports all major LLM providers out of the box and ships with curated model packs that balance capability, cost, and speed. > Note on hosting: Plandex Cloud is winding down as of October 2025 and no longer accepting new users. New adopters should plan for self-hosted deployment via Docker or local mode using their own API keys. ## Key Features ### Smart Context Management at Scale Plandex's context engine loads only what is needed for each step, giving you an effective 2M token working window. For projects with 20M+ tokens of source code, tree-sitter project maps provide fast, syntax-validated indexing so the agent understands your codebase structure without loading everything at once. ### Configurable Autonomy Plandex adapts to how you want to work. In full auto-mode, it loads files, plans changes, implements them, runs commands, and debugs failures automatically. You can also approve every file change and command before execution. That flexibility makes Plandex work for quick trusted edits and high-stakes changes alike. ### Cumulative Diff Review Sandbox Every AI-generated change stays in a protected sandbox. Plandex presents a complete, cumulative diff of every proposed modification — across all files and steps — before a single byte is written to your project. You can review, revise, reject, or approve individual changes in any order. This git-style workflow prevents the messy repo problem common with other AI coding tools. ### Provider-Agnostic with Model Packs Plandex works with Anthropic, OpenAI, Google, Mistral, DeepSeek, Ollama, OpenRouter, and any OpenAI-compatible API. Curated model packs let you switch between configurations optimized for maximum capability (Claude Opus + GPT-4o), cost efficiency (fast models), or speed. Plandex also supports Claude Pro/Max subscriptions and uses context caching across all major providers to reduce costs and latency. Multi-layered provider fallback keeps you running when one API is degraded. ### Additional Capabilities - Version control for plans — every update to a plan is versioned; create branches to explore different approaches, compare outputs from different models side by side, and roll back to any previous state - Automated debugging — of builds, linters, tests, deployments, and browser apps (via Chrome) - Project-aware chat mode — explore ideas, ask questions, or learn a codebase before implementing - Git integration — automatic commit message generation with optional auto-commits - REPL mode — fuzzy auto-complete for commands and file loading; just run `pdx` in any project - Dockerized local mode — self-host the server with minimal setup ## How It Works Start Plandex by running `pdx` or `plandex new` inside any project directory. Describe what you want to build or change in natural language. Plandex maps your project structure with tree-sitter, loads relevant files into context, and generates a plan broken into steps. For each step, the agent proposes file changes, runs commands, and debugs failures — all inside the sandbox. You review the cumulative diff and approve, reject, or request revisions. Once approved, the changes are applied to your project. ## Installation and Hosting Plandex installs via GitHub releases on macOS, Linux, and Windows (via WSL). The official website (`plandex.ai`) and documentation site (`docs.plandex.ai`) are currently unreachable — the safest bet is to grab binaries directly from the GitHub releases page . The self-hosted local mode uses Docker to run the server on your own machine with your own API keys. Plandex Cloud is winding down as of October 2025 and no longer accepting new users, making self-hosting the primary path for new adopters. ## Comparison Context Plandex sits in a unique spot among AI coding agents. It is closest in spirit to Aider , the other major terminal-first AI coding tool, but takes a different approach to change management. Aider uses automatic git commits for every change — edits go directly to your files and are committed immediately. Plandex, by contrast, accumulates all changes in a protected sandbox and presents them as a cumulative diff for your review before anything touches your project. This makes Plandex the safer choice for large refactors and production code, while Aider's auto-commit approach is faster for smaller, low-risk edits. Against Cline and Roo Code , the difference is philosophical. Those tools integrate into VS Code as extensions and edit files in place (with optional diff review). Plandex is terminal-first and sandbox-first — diff review is not optional but baked into the core workflow. This makes Plandex feel more like a `git` subcommand than an IDE plugin, which appeals to developers who prefer working in the shell. Where Plandex wins: - Safety-critical changes where you want full control before code lands in your repo - Very large codebases (20M+ tokens) — its context engine and tree-sitter maps handle scale better than most alternatives - Complex, multi-file refactors that span dozens of files and many steps - Teams that want an auditable, reviewable trail of AI-generated changes Where it falls short: - Terminal-only — no GUI or IDE integration for developers who prefer visual diff tools - Smaller community and ecosystem compared to Cline, Roo Code, or Aider - Requires self-hosting in local mode since Cloud is winding down - Less suitable for quick, one-off edits where full sandbox review feels heavy If you live in the terminal and work on large, multi-file projects, Plandex's diff-first, sandboxed approach makes sense — especially when mistakes are expensive. ### Further Reading - Official Documentation - GitHub Repository - GitHub Releases - Discord Community ## Version History cli/v2.2.1 Jul 16, 2025 Claude Pro/Max subscription support, multi-provider resilience improvements, bug fixes Best for Developers tackling long-horizon, multi-file coding tasks from the terminal who want a sandboxed, diff-first workflow with configurable autonomy and provider flexibility Capability Protected sandbox, cumulative diff review, 2M token context, tree-sitter project maps, configurable autonomy, curated model packs, provider-agnostic, terminal-first, git-style change control Runs on CLI · macOS · Windows (WSL) · Linux Signature Snippet Copy ``` `From the terminal: run `pdx` or `plandex new` then 'Refactor the authentication module to use JWT, update all dependent routes and middleware, add unit tests, and update the README.' Plandex uses tree-sitter to map the project, loads only relevant files into its 2M token context window, proposes changes across all files in a protected sandbox, and presents a cumulative diff for review before anything touches your repo. From there you can approve, revise, or continue iterating.` ``` ## More in this Space SO ### Sourcery Closed source AI code review platform for the AI era. Automated code reviews, security scanning, and team analytics across GitHub, GitLab, VS Code, and JetBrains. Used by 300,000+ developers. View profile WT ### What The Diff Closed source AI-powered PR description generator and code review assistant. Automatically writes pull request descriptions, sends stakeholder notifications, creates changelogs, and provides inline code refactoring. View profile BA ### Blackbox AI Closed source Multi-agent AI coding platform with 12+ agents and 24+ models, featuring Chairman LLM for parallel multi-agent evaluation and end-to-end encrypted inference. Ships across six surfaces: CLI, IDE, Cloud, API, Mobile, and Builder. View profile