Plandex
Terminal AI agent for large tasks: plans and applies changes across dozens of files through a diff review sandbox
Install
curl -sL https://plandex.ai/install.sh | bashLinux and macOS, Windows only via WSL
This is third-party code. Review the repository files before installing.
What it does
Plandex plans and executes large tasks that touch many files. Changes accumulate in a separate sandbox with a cumulative diff and reach the project only after review. It builds project maps with tree-sitter, handles up to 2M tokens of context and can run builds, linters and tests and debug failures on its own. It offers plan branches, git integration, a chat mode and configurable autonomy.
Who it is for. Developers working on large projects who want control over agent changes.
Good fit when
- The task touches dozens of files and other agents struggle with it
- You want to review all changes before they are applied
- You want to compare model outputs using plan branches
- The project is large and needs indexing via project maps
Not a fit when
- You are on Windows without WSL
- You expect to use Plandex Cloud: it is winding down and closed to new users
Example request
Migrate this service's database layer from raw SQL to an ORM across all data repositories and show me the diffLimitations
On Windows it works only in WSL. Plandex Cloud has been winding down since October 2025, leaving local Docker mode or self-hosting with your own provider keys.
How to disable. Remove the plandex binary and stop the local Docker server if it is running.
Security check
- The installer downloads and runs a script
- In autonomous mode it runs commands and edits files
- Code is sent to model providers
README in short
Plandex is a terminal AI development tool built for large tasks and real projects. The README covers context management, the diff review sandbox, configurable autonomy, automated debugging and plan versioning. It installs with one command and has a Dockerized local mode. The cloud option is winding down, so self-hosting is the main path.
FAQ
Can I use a Claude Pro or Max subscription?
Yes, on first run Plandex offers to connect a subscription for Anthropic models.
Is git required?
No, but Plandex integrates well with git, generates commit messages and can commit automatically.
Related
A self-improving agent from Nous Research with a TUI, messaging gateway, cron jobs and skills it writes itself
Anthropic's coding agent for the terminal, IDE and GitHub: understands your codebase, runs tasks and handles git
OpenAI's coding agent that runs locally in your terminal, with IDE and desktop versions
Google's open-source terminal agent on Gemini models: code work, shell, web search and MCP