https://github.com/plandex-ai/plandex Skip to content Toggle navigation Sign in * Product + Actions Automate any workflow + Packages Host and manage packages + Security Find and fix vulnerabilities + Codespaces Instant dev environments + Copilot Write better code with AI + Code review Manage code changes + Issues Plan and track work + Discussions Collaborate outside of code Explore + All features + Documentation + GitHub Skills + Blog * Solutions For + Enterprise + Teams + Startups + Education By Solution + CI/CD & Automation + DevOps + DevSecOps Resources + Learning Pathways + White papers, Ebooks, Webinars + Customer Stories + Partners * Open Source + GitHub Sponsors Fund open source developers + The ReadME Project GitHub community articles Repositories + Topics + Trending + Collections * Pricing Search or jump to... Search code, repositories, users, issues, pull requests... Search [ ] Clear Search syntax tips Provide feedback We read every piece of feedback, and take your input very seriously. [ ] [ ] Include my email address so I can be contacted Cancel Submit feedback Saved searches Use saved searches to filter your results more quickly Name [ ] Query [ ] To see all available qualifiers, see our documentation. Cancel Create saved search Sign in Sign up You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert {{ message }} plandex-ai / plandex Public * Notifications * Fork 17 * Star 449 * An AI coding engine for complex tasks plandex.ai License AGPL-3.0 license 449 stars 17 forks Branches Tags Activity Star Notifications * Code * Issues 5 * Pull requests 0 * Discussions * Actions * Projects 0 * Security * Insights Additional navigation options * Code * Issues * Pull requests * Discussions * Actions * Projects * Security * Insights plandex-ai/plandex This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository. main BranchesTags Go to file Code Folders and files Name Name Last commit message Last commit date Latest commit History 444 Commits app app guides guides images images prompts prompts releases releases test test .gitignore .gitignore LICENSE LICENSE README.md README.md dev.sh dev.sh View all files Repository files navigation * README * AGPL-3.0 license [plandex-logo-dark-bg] An open source, terminal-based AI coding engine for complex tasks. PRs Welcome Release Release Install * Usage * Self-Hosting * Development * Discord Plandex uses long-running agents to complete tasks that span multiple files and require many steps. It breaks up large tasks into smaller subtasks, then implements each one, continuing until it finishes the job. It helps you churn through your backlog, work with unfamiliar technologies, get unstuck, and spend less time on the boring stuff. Plandex intro video Build complex software with LLMs [?][?] Changes are accumulated in a protected sandbox so that you can review them before automatically applying them to your project files. Built-in version control allows you to easily go backwards and try a different approach. Branches allow you to try multiple approaches and compare the results. Manage context efficiently in the terminal. Easily add files or entire directories to context, and keep them updated automatically as you work so that models always have the latest state of your project. Plandex relies on the OpenAI API and requires an OPENAI_API_KEY environment variable. Support for open source models, Google Gemini, and Anthropic Claude is coming soon. Plandex supports Mac, Linux, FreeBSD, and Windows. It runs from a single binary with no dependencies. Install Quick install curl -sL https://plandex.ai/install.sh | bash Manual install Grab the appropriate binary for your platform from the latest release and put it somewhere in your PATH. Build from source git clone https://github.com/plandex-ai/plandex.git cd plandex/app/cli go build -ldflags "-X plandex/version.Version=$(cat version.txt)" mv plandex /usr/local/bin # adapt as needed for your system Windows Windows is supported via Git bash or WSL. Get started If you don't have an OpenAI account, first sign up here. Then generate an API key here. cd your-project export OPENAI_API_KEY=... plandex new After any plandex command is run, commands that could make sense to run next will be suggested. You can learn to use Plandex quickly by jumping in and following these suggestions. Usage [?] Here's a quick overview of the commands and functionality. Help [?] To see all available commands: plandex help For help on any command: plandex [command] --help Why Plandex? [?] Go beyond autocomplete to build complex functionality with AI. Stop the mouse-centered, copy-pasting madness of coding with ChatGPT. Manage context efficiently in the terminal. [?][?] Ensure AI models always have the latest versions of files in context. Retain granular control over what's in context and how many tokens you're using. Experiment, revise, and review in a protected sandbox before applying changes. [?] Rewind and retry as needed. Explore multiple approaches with branches. Run tasks in the background or work on multiple tasks in parallel. [?] Try different models and model settings, then compare results. Plandex Cloud [?] Plandex Cloud is the easiest and most reliable way to use Plandex. You'll be prompted to start an anonymous trial (no email required) when you create your first plan with plandex new. Trial accounts are limited to 10 plans and 10 AI model replies per plan. You can upgrade to an unlimited account with your name and email. Plandex Cloud accounts are free for now. In the future, they will cost somewhere in the $10-20 per month range. Self-hosting Read about self-hosting Plandex here. Limitations and guidance [?][?] * Plandex can provide a significant boost to your productivity, but as with any other AI tool, you shouldn't expect perfect results. Always review a plan carefully before applying changes, especially if security is involved. Plandex is designed to get you 80-90% of the way there rather than 100%. * Due to the reasoning limitations of LLMs, automatically applied file updates also aren't perfect. While these can be improved over time with better prompting strategies (contributions welcome) and better models, be prepared for occasional updates that aren't quite right. Use the plandex changes command to review pending updates in a TUI. If a file update has mistakes, make those changes yourself with copy-and-paste and reject the file in the changes TUI. * The more direction and detail you provide, the better the results will be. Working with Plandex often involves giving it a prompt, seeing that the results are a bit off, then using plandex rewind to go back and iterate on the prompt or add context before trying again. Branches are also useful for trying different approaches. * While it can be tempting to just dump your entire project into context if it fits under the token limit, with current models you will tend to see better results (and pay less) by being more selective about what's loaded into context. Security Plandex Cloud follows best practices for network and data security. And whether cloud or self-hosted, Plandex protects model provider API keys (like your OpenAI API key). Read more here. Privacy and data retention [?] Read about Plandex Cloud's privacy and data retention policies here. Roadmap [?] Support for open source models, Google Gemini, and Anthropic Claude in addition to OpenAI Plan sharing and team collaboration [?] Support for GPT4-Vision and other multi-modal models--add images and screenshots to context [?] VSCode and JetBrains extensions Community plugins and modules Github integration Web dashboard and GUI SOC2 compliance [?] Fine-tuned models This list will grow and be prioritized based on your feedback. Discussion and discord Speaking of feedback, feel free to give yours, ask questions, report a bug, or just hang out: * Discord * Discussions * Issues Contributors [?] Please star, fork, explore, and contribute to Plandex. There's a lot of work to do and so much that can be improved. Work on tests, evals, prompts, and bug fixes is especially appreciated. Here's an overview on setting up a development environment. Comparable tools [?][?] * Aider * Mentat * Pythagora Gpt-pilot * Sourcegraph Cody * Continue.dev * Sweep.dev * Cursor * Github Copilot * Replit Ghostwriter * Grimoire About the developer Hi, I'm Dane. I've been building and launching software products for 17 years. I went through YCombinator in winter 2018 with my devops security company, EnvKey, which I continue to run today. I'm fascinated by LLMs and their potential to transform the practice of software development. I live with my wife and 4 year old daughter on the SF peninsula in California. I grew up in the Finger Lakes region of upstate New York. I like reading fiction, listening to podcasts, fitness, and surfing. About An AI coding engine for complex tasks plandex.ai Topics cli golang ai openai developer-tools terminal-based ai-agents polyglot-programming ai-tools gpt-4 llm ai-developer-tools Resources Readme License AGPL-3.0 license Activity Custom properties Stars 449 stars Watchers 4 watching Forks 17 forks Report repository Releases 10 Release cli/v0.8.1 Latest Apr 3, 2024 + 9 releases Contributors 2 * @danenania danenania Dane Schneider * @harleypig harleypig Alan Young Languages * Go 97.5% * Shell 1.2% * Other 1.3% Footer (c) 2024 GitHub, Inc. Footer navigation * Terms * Privacy * Security * Status * Docs * Contact * Manage cookies * Do not share my personal information You can't perform that action at this time.