plandex-ai /plandex
Open source AI coding agent. Designed for large projects and real world tasks.
★ 15,919⑂ 1,192👁 109⑃ 99● 211▤ 73
+4
日增长
15,919
stars
1,192
forks
109
watchers
99
prs
211
issues
73
releases
README
30-Second Install
·
Website
·
Docs
·
Examples
·
Local Self-Hosted Mode
--
An AI coding agent designed for large tasks and real world projects.
Designed for large tasks and real world projects.
--
💻 Plandex is a terminal-based AI development tool that can plan and execute large coding tasks that span many steps and touch dozens of files. It can handle up to 2M tokens of context directly (~100k per file), and can index directories with 20M tokens or more using tree-sitter project maps.
🔬 A cumulative diff review sandbox keeps AI-generated changes separate from your project files until they are ready to go. Command execution is controlled so you can easily roll back and debug. Plandex helps you get the most out of AI without leaving behind a mess in your project.
🧠 Combine the best models from Anthropic, OpenAI, Google, and open source providers to build entire features and apps with a robust terminal-based workflow.
🚀 Plandex is capable of full autonomy—it can load relevant files, plan and implement changes, execute commands, and automatically debug—but it's also highly flexible and configurable, giving developers fine-grained control and a step-by-step review process when needed.
💪 Plandex is designed to be resilient to large projects and files. If you've found that others tools struggle once your project gets past a certain size or the changes are too complex, give Plandex a shot.
Smart context management that works in big projects
- 🐘 2M token effective context window with default model pack. Plandex loads only what's needed for each step.
- 🗄️ Reliable in large projects and files. Easily generate, review, revise, and apply changes spanning dozens of files.
- 🗺️ Fast project map generation and syntax validation with tree-sitter. Supports 30+ languages.
- 💰 Context caching is used across the board for OpenAI, Anthropic, and Google models, reducing costs and latency.
Tight control or full autonomy—it's up to you
- 🚦 Configurable autonomy: go from full auto mode to fine-grained control depending on the task.
- 🐞 Automated debugging of terminal commands (like builds, linters, tests, deployments, and scripts). If you have Chrome installed, you can also automatically debug browser applications.
Tools that help you get production-ready results
- 💬 A project-aware chat mode that helps you flesh out ideas before moving to implementation. Also great for asking questions and learning about a codebase.
- 🧠 Easily try + combine models from multiple providers. Curated model packs offer different tradeoffs of capability, cost, and speed, as well as open source and provider-specific packs.
- 🛡️ Reliable file edits that prioritize correctness. While most edits are quick and cheap, Plandex validates both syntax and logic Top issues
#40🚨 Error resolving auth → Error selecting auth option → Unexpected escape sequence from terminal → ['\x1b' '\\']9 comments · 2024-04-06#319Support for Agent Hooks5 comments · 2026-02-03#241MCP4 comments · 2025-04-28#119[Again] Feature Request: Support for Azure OpenAI API3 comments · 2024-05-14#98prepareEditorCommand doesn't accept arguments4 comments · 2024-04-20#324Suggestion: HADS format for context files — reduces token waste for loaded docs2 comments · 2026-03-12#304Nil pointer dereference on no credits from openrouter.2 comments · 2025-10-20#286Support gemini flash 2.5 ?2 comments · 2025-06-27
Discussions
#374Plandex is included in the AgentManager tool catalog0 comments · 2026-10-16#370Served context ceilings are per-endpoint and undocumented, which makes them a per-role problem in model packs0 comments · 2026-09-26#356Proposal: Add Aurelo as a first-class model provider0 comments · 2026-07-14#351ccline: AI at the zsh prompt — quick shell assistant for when you're not doing a full dev task0 comments · 2026-06-10#348Feedback request: review packet for AI-written PRs0 comments · 2026-06-01#347[Closed] Test discussion0 comments · 2026-06-01#346Authority receipts before coding-agent side effects0 comments · 2026-05-25#345Open source Claude Code skills for investment analysis — options flow scanner + price alerts0 comments · 2026-05-13
Latest release
Release cli/v2.2.1 cli/v2.2.1 2025-07-16🖇️ Connect your Claude Pro or Max subscription If you have a Claude Pro or Max subscription, Plandex can use it when calling Anthropic models. You can use it in either Integrated Models Mode on Plandex Cloud, or in BYO Key Mode (whether on Cloud or self-hosting). Assuming you're using Anthropic models (which the default model pack does), you'll be asked if you want to connect your Claude subscription the first time you run Plandex. Follow the instructions to connect. Learn more in the docs. 🐞 Bug fixes Fixed an issue with custom models and providers.