Plandex

Introduction to Plandex

Plandex is an open-source, terminal-based AI coding agent designed to assist developers in managing complex software projects. It offers a robust, git-inspired workflow that enables users to plan, implement, and review changes across multiple files and steps. With support for up to 2 million tokens of context and tree-sitter project maps, Plandex is built to handle large-scale tasks efficiently.

Key Features

• Configurable Autonomy: Plandex adapts to your task and comfort level, allowing you to switch between full automation and granular step-by-step control.
• Change Isolation: Stage and review diffs across many files, execute commands, roll back on failure, and automatically debug, ensuring that changes are isolated until they’re ready to be applied.
• Multi-Model Integration: Combine models from providers like OpenAI, Anthropic, Google, and more, enabling you to use the right model for each stage of your project.
• Large Project Support: With a 2M token effective context window and tree-sitter project maps, Plandex can handle heavier tasks than other tools, making it ideal for large projects and files.

How to Use Plandex

Getting started with Plandex is straightforward:

1. Installation: Run the following command to install Plandex:

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

   Note: Windows is supported via WSL; it doesn’t work in the Windows CMD prompt or PowerShell.

2. Set Up Your Project: Create a new directory for your project and navigate into it:

   mkdir your-project-dir
   cd your-project-dir

3. Start a Plan: Begin a new plan with:

   plandex new

4. Load Files: Add relevant files or directories to the context:

   plandex load src/components -r

5. Interact with Plandex: Use the REPL to communicate with Plandex:

   plandex

Pricing

Plandex offers several pricing plans to suit different needs:

• Open Source (Free): Run the Plandex server locally or host on your own infrastructure. Includes all Plandex features under the MIT license. Use your own OpenRouter.ai, OpenAI, and other OpenAI-compatible provider accounts. Manage billing directly with providers.
• Cloud Integrated Models ($45/month): The quickest way to get started. No separate accounts needed. Includes $20 in credits every month that never expire. Use Plandex credits with the latest models from providers like OpenAI, Anthropic, Google, DeepSeek, Qwen, Perplexity, and more. Start with a $10 trial (includes $10 in credits).
• Cloud BYO API Key ($30/month): Use your own OpenRouter.ai account. Free trial up to 10 plans / 20 responses per plan. Manage billing directly with providers. Offers the same benefits as the Integrated Models plan, leaving aside provider accounts and billing.

Frequently Asked Questions

• What is a plan in Plandex? A plan in Plandex is similar to a conversation in ChatGPT or Claude. It might include a single prompt and model response that executes one small task, or it could encompass a long back and forth with the model that generates dozens of files and builds a whole feature or an entire app.
• Do credits expire? No, Plandex credits are valid until you use them.
• What if I run out of credits? You can buy more credits anytime. The minimum purchase is $10. You can enable auto-recharge to buy credits when your balance gets too low. You can also set a maximum monthly spend limit or get notified by email when you spend a certain amount.
• Can I pause my subscription? Yes, you can pause your subscription at any time.