LibreAI / Dev Tools / plandex
// devtools · plandex-ai/plandex

plandex

Open-source terminal AI coding agent built for large projects and multi-step, real-world tasks.

★ 15.7k stars⑂ 1.2k forksMITupdated 2025-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

plandex is an open-source dev tools project by plandex-ai (plandex-ai/plandex on GitHub). It has 15,702 GitHub stars and 1,176 forks, is released under the MIT license, and was last updated on GitHub on 3 October 2025.

GitHub stars
15,702
Forks
1,176
License
MIT
Last updated on GitHub
3 October 2025
Category
Dev Tools
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify the task for your project

    Decide what you want built or changed; Plandex suits multi-step work touching many files, and its chat mode can help flesh out the plan first.

  2. Install the CLI

    Install Plandex with the one-line installer (on Windows, use WSL), which adds the plandex command with no dependencies.

  3. Connect a model provider

    Add your OpenRouter or other provider API key, or connect a Claude Pro/Max subscription when prompted on first run.

  4. Start the REPL in your project

    cd into your project directory, run plandex, describe the task, then review the sandboxed diff before applying changes.

// features

Why people love it

Built for large projects

Handles up to 2M tokens of context directly (about 100k per file) and can index directories of 20M tokens or more using tree-sitter project maps.

Diff review sandbox

AI-generated changes stay in a cumulative diff sandbox, separate from your project files, until you review and apply them, with rollback for debugging.

Configurable autonomy

Go from full-auto mode - loading files, implementing, executing commands and auto-debugging - to step-by-step review when you want control.

Multi-model packs

Combine models from Anthropic, OpenAI, Google and open-source providers, with curated packs trading off capability, cost and speed, plus context caching.

Version control for plans

Every plan update is versioned, with branches to explore multiple paths or compare models, plus Git integration and commit-message generation.

Automated debugging

Automatically debugs terminal commands such as builds, linters and tests, and can debug browser apps when Chrome is installed.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone the Plandex source if you want to build or inspect it; most users install the CLI directly instead.

    git clone https://github.com/plandex-ai/plandex.git
    cd plandex
  2. Install the CLI

    Install Plandex with the official one-line, zero-dependency installer from the README.

    curl -sL https://plandex.ai/install.sh | bash
  3. Start it in a project

    Move into your project directory and launch the REPL (pdx for short), then describe your task.

    plandex
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains Plandex?

Plandex is developed by plandex-ai and open-source contributors.

Is Plandex free to use?

The CLI is open source under MIT. You run it in local mode with Docker and your own model-provider keys; the README notes Plandex Cloud is winding down and no longer accepts new users.

Does it need a paid API key?

Yes, in practice: you supply your own OpenRouter or other provider key, or connect a Claude Pro/Max subscription, and pay that provider for model usage.

How does Plandex compare with Cursor or Claude Code?

Plandex is a terminal-first agent focused on very large projects and multi-step plans, with a diff-review sandbox and plan branching; editor-based tools focus more on inline editing inside an IDE.

How do I get started?

Run the one-line installer, cd into a project, type plandex, connect a provider, and describe the task.

// keep exploring

Similar tools

Dev Tools

DeepSeek-Reasonix

A terminal coding agent built for DeepSeek models — reliable, cache-aware and cheap to run

★ 35.7k starsMIT
View guide →
Dev Tools

herdr

The terminal runtime your coding agents live on — a Rust multiplexer built for agent sessions

★ 42.9k starsApache-2.0
View guide →
Dev Tools

CountBot

Lightweight open-source AI coding agent built for Chinese developers.

★ 781 starsMIT
View guide →
Dev Tools

agav

Terminal-native AI coding assistant for real repositories.

★ 147 starsApache-2.0
View guide →
Dev Tools

codex

OpenAI's lightweight coding agent that runs locally in your terminal

★ 128.2k starsApache-2.0
View guide →
Dev Tools

spettro

Spettro is a terminal coding assistant built in Go.

★ 36 starsGPL-3.0
View guide →
// alternatives

Alternatives in Dev Tools

The most-starred other Dev Tools projects in the LibreAI catalogue — the realistic shortlist if plandex is not the right fit.

Get plandex

Free and open — grab the source, star the repo, and start creating.