Plandex

Terminal AI agent for large tasks: plans and applies changes across dozens of files through a diff review sandbox

CLIHigh risk

plandex-ai/plandex

Install

curl -sL https://plandex.ai/install.sh | bash

Linux 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 diff

Limitations

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.

Editors’ pick

A self-improving agent from Nous Research with a TUI, messaging gateway, cron jobs and skills it writes itself

CLIHigh risk245.5K
Editors’ pick

Anthropic's coding agent for the terminal, IDE and GitHub: understands your codebase, runs tasks and handles git

CLIHigh risk145K
Editors’ pick

OpenAI's coding agent that runs locally in your terminal, with IDE and desktop versions

CLIHigh risk124.1K
Editors’ pick

Google's open-source terminal agent on Gemini models: code work, shell, web search and MCP

CLIHigh risk107K