{"id":7394153,"url":"https://github.com/plandex-ai/plandex","last_synced_at":"2025-10-04T07:59:22.801Z","repository":{"id":227663024,"uuid":"709538270","full_name":"plandex-ai/plandex","owner":"plandex-ai","description":"Open source AI coding agent. Designed for large projects and real world tasks.","archived":false,"fork":false,"pushed_at":"2025-10-02T21:55:33.000Z","size":56794,"stargazers_count":14509,"open_issues_count":31,"forks_count":1020,"subscribers_count":99,"default_branch":"main","last_synced_at":"2025-10-02T23:36:23.955Z","etag":null,"topics":["ai","ai-agents","ai-developer-tools","ai-tools","cli","command-line","developer-tools","git","golang","gpt-4","llm","openai","polyglot-programming","terminal","terminal-based","terminal-ui"],"latest_commit_sha":null,"homepage":"https://plandex.ai","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/plandex-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-10-24T22:11:43.000Z","updated_at":"2025-10-02T16:56:35.000Z","dependencies_parsed_at":"2024-04-14T19:36:01.764Z","dependency_job_id":"d3c57013-f6c1-4547-bbc7-11464f3d50f4","html_url":"https://github.com/plandex-ai/plandex","commit_stats":null,"previous_names":["plandex-ai/plandex"],"tags_count":73,"template":false,"template_full_name":null,"purl":"pkg:github/plandex-ai/plandex","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plandex-ai%2Fplandex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plandex-ai%2Fplandex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plandex-ai%2Fplandex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plandex-ai%2Fplandex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/plandex-ai","download_url":"https://codeload.github.com/plandex-ai/plandex/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plandex-ai%2Fplandex/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278283511,"owners_count":25961311,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agents","ai-developer-tools","ai-tools","cli","command-line","developer-tools","git","golang","gpt-4","llm","openai","polyglot-programming","terminal","terminal-based","terminal-ui"],"created_at":"2024-04-04T13:06:10.278Z","updated_at":"2025-10-04T07:59:22.796Z","avatar_url":"https://github.com/plandex-ai.png","language":"Go","funding_links":[],"categories":["AI Agent Frameworks","🚀 AI Tools for Vim, Neovim, and Terminal","Autonomous Coding Agents","[Plandex](https://github.com/plandex-ai/plandex)","AI Сервисы для разработки ПО","Go","\u003cimg src=\"./assets/satellite.svg\" width=\"16\" height=\"16\" style=\"vertical-align: middle;\"\u003e Satellites","HarmonyOS","Image Generation \u0026 Editing","Software Development","Text","A01_文本生成_文本对话","CLIs","Table of Contents","Recently Updated","Coding","其他LLM框架","AI code assistants/search","Terminal \u0026 CLI Agents","⚙️ Natural Language to Code Tools","Projects","cli","Agent Harness 🚀","AI Tools","Repos","Other LLM Frameworks","Vim (text editor)","Table of Open-Source AI Agents Projects","ai","Developer \u0026 Coding Assistants","Learning","AI Coding Assistants \u0026 Agents","🚀 Specialized Agents","Agent Orchestration","Agent Categories","Code-Focused Agent Tools","🤖 AI \u0026 Machine Learning","1. Local Agents","🖥 Companion CLI Tools","Applications","AI Coding Agents","Open Source Tools","Terminal-native coding agents","Agent Applications","命令行工具"],"sub_categories":["General Agent Frameworks","Links","Генераторы ПО “с нуля” и AI-разработчики","Windows Manager","Developer tools","大语言对话模型及数据","Code Assistant","[Feb 16, 2025](/content/2025/02/16/README.md)","Coding Assistants","文章","链接","🧠 AI Agent","5. The Convergence: Harness-as-a-Service (HaaS)","👨‍💻 Developer Tools","Videos Playlists","Offline usage \u003ca href=\"https://github.com/chubin/cheat.sh#installation\"\u003einstall\u003c/a\u003e cheat script manually\u003cbr\u003e","Code Generation \u0026 Refactoring","Repositories","Autonomous Software Engineers","💻 Coding Agents","\u003ca name=\"Unclassified\"\u003e\u003c/a\u003eUnclassified","Open Source — Model-Agnostic","Coding Agents \u0026 IDE Extensions","AI","General Purpose","Agent Memory \u0026 Context","Open Source"],"readme":"\u003ch1 align=\"center\"\u003e\r\n \u003ca href=\"https://plandex.ai\"\u003e\r\n  \u003cpicture\u003e\r\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"images/plandex-logo-dark-v2.png\"/\u003e\r\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"images/plandex-logo-light-v2.png\"/\u003e\r\n    \u003cimg width=\"400\" src=\"images/plandex-logo-dark-bg-v2.png\"/\u003e\r\n \u003c/a\u003e\r\n \u003cbr /\u003e\r\n\u003c/h1\u003e\r\n\u003cbr /\u003e\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n\r\n\u003cp align=\"center\"\u003e\r\n  \u003c!-- Call to Action Links --\u003e\r\n  \u003ca href=\"#install\"\u003e\r\n    \u003cb\u003e30-Second Install\u003c/b\u003e\r\n  \u003c/a\u003e\r\n   ·\r\n  \u003ca href=\"https://plandex.ai\"\u003e\r\n    \u003cb\u003eWebsite\u003c/b\u003e\r\n  \u003c/a\u003e\r\n   ·\r\n  \u003ca href=\"https://docs.plandex.ai/\"\u003e\r\n    \u003cb\u003eDocs\u003c/b\u003e\r\n  \u003c/a\u003e\r\n   ·\r\n  \u003ca href=\"#examples-\"\u003e\r\n    \u003cb\u003eExamples\u003c/b\u003e\r\n  \u003c/a\u003e\r\n   ·\r\n  \u003ca href=\"https://docs.plandex.ai/hosting/self-hosting/local-mode-quickstart\"\u003e\r\n    \u003cb\u003eLocal Self-Hosted Mode\u003c/b\u003e\r\n  \u003c/a\u003e\r\n\u003c/p\u003e\r\n\r\n\u003cbr\u003e\r\n\r\n[![Discord](https://img.shields.io/discord/1214825831973785600.svg?style=flat\u0026logo=discord\u0026label=Discord\u0026refresh=1)](https://discord.gg/plandex-ai)\r\n[![GitHub Repo stars](https://img.shields.io/github/stars/plandex-ai/plandex?style=social)](https://github.com/plandex-ai/plandex)\r\n[![Twitter Follow](https://img.shields.io/twitter/follow/PlandexAI?style=social)](https://twitter.com/PlandexAI)\r\n\r\n\u003c/div\u003e\r\n\r\n\u003cp align=\"center\"\u003e\r\n  \u003c!-- Badges --\u003e\r\n\u003ca href=\"https://github.com/plandex-ai/plandex/pulls\"\u003e\u003cimg src=\"https://img.shields.io/badge/PRs-welcome-brightgreen.svg\" alt=\"PRs Welcome\" /\u003e\u003c/a\u003e \u003ca href=\"https://github.com/plandex-ai/plandex/releases?q=cli\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/plandex-ai/plandex?filter=cli*\" alt=\"Release\" /\u003e\u003c/a\u003e\r\n\u003ca href=\"https://github.com/plandex-ai/plandex/releases?q=server\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/plandex-ai/plandex?filter=server*\" alt=\"Release\" /\u003e\u003c/a\u003e\r\n\r\n  \u003c!-- \u003ca href=\"https://github.com/your_username/your_project/issues\"\u003e\r\n    \u003cimg src=\"https://img.shields.io/github/issues-closed/your_username/your_project.svg\" alt=\"Issues Closed\" /\u003e\r\n  \u003c/a\u003e --\u003e\r\n\r\n\u003c/p\u003e\r\n\r\n\u003cbr /\u003e\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n\u003ca href=\"https://trendshift.io/repositories/8994\" target=\"_blank\"\u003e\u003cimg src=\"https://trendshift.io/api/badge/repositories/8994\" alt=\"plandex-ai%2Fplandex | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"/\u003e\u003c/a\u003e\r\n\u003c/div\u003e\r\n\r\n\u003cbr\u003e\r\n\r\n\u003ch1 align=\"center\" \u003e\r\n  An AI coding agent designed for large tasks and real world projects.\u003cbr/\u003e\u003cbr/\u003e\r\n\u003c/h1\u003e\r\n\r\n\u003c!-- \u003ch2 align=\"center\"\u003e\r\n  Designed for large tasks and real world projects.\u003cbr/\u003e\u003cbr/\u003e\r\n  \u003c/h2\u003e --\u003e\r\n  \u003cbr/\u003e\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003ca href=\"https://www.youtube.com/watch?v=SFSu2vNmlLk\"\u003e\r\n    \u003cimg src=\"images/plandex-v2-yt.png\" alt=\"Plandex v2 Demo Video\" width=\"800\"\u003e\r\n  \u003c/a\u003e\r\n\u003c/div\u003e\r\n\r\n\u003cbr/\u003e\r\n\r\n💻  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.\r\n\r\n🔬  **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.\r\n\r\n🧠  **Combine the best models** from Anthropic, OpenAI, Google, and open source providers to build entire features and apps with a robust terminal-based workflow.\r\n\r\n🚀  Plandex is capable of \u003cstrong\u003efull autonomy\u003c/strong\u003e—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.\r\n\r\n💪  Plandex is designed to be resilient to \u003cstrong\u003elarge projects and files\u003c/strong\u003e. 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.\r\n\r\n## Smart context management that works in big projects\r\n\r\n- 🐘 **2M token effective context window** with default model pack. Plandex loads only what's needed for each step.\r\n\r\n- 🗄️ **Reliable in large projects and files.** Easily generate, review, revise, and apply changes spanning dozens of files.\r\n\r\n- 🗺️ **Fast project map generation** and syntax validation with tree-sitter. Supports 30+ languages.\r\n\r\n- 💰 **Context caching** is used across the board for OpenAI, Anthropic, and Google models, reducing costs and latency.\r\n\r\n## Tight control or full autonomy—it's up to you\r\n\r\n- 🚦 **Configurable autonomy:** go from full auto mode to fine-grained control depending on the task.\r\n\r\n- 🐞 **Automated debugging** of terminal commands (like builds, linters, tests, deployments, and scripts). If you have Chrome installed, you can also automatically debug browser applications.\r\n\r\n## Tools that help you get production-ready results\r\n\r\n- 💬 **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.\r\n\r\n- 🧠 **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.\r\n\r\n- 🛡️ **Reliable file edits** that prioritize correctness. While most edits are quick and cheap, Plandex validates both syntax and logic as needed, with multiple fallback layers when there are problems.\r\n\r\n- 🔀 **Full-fledged version control** for every update to the plan, including branches for exploring multiple paths or comparing different models.\r\n\r\n- 📂 **Git integration** with commit message generation and optional automatic commits.\r\n\r\n## Dev-friendly, easy to install\r\n\r\n- 🧑‍💻 **REPL mode** with fuzzy auto-complete for commands and file loading. Just run `plandex` in any project to get started.\r\n\r\n- 🛠️ **CLI interface** for scripting or piping data into context.\r\n\r\n- 📦 **One-line, zero dependency CLI install**. Dockerized local mode for easily self-hosting the server. Cloud-hosting options for extra reliability and convenience.\r\n\r\n## Workflow  🔄\r\n\r\n\u003cimg src=\"images/plandex-workflow.png\" alt=\"Plandex workflow\" width=\"100%\"/\u003e\r\n\r\n## Examples  🎥\r\n\r\n  \u003cbr/\u003e\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003ca href=\"https://www.youtube.com/watch?v=g-_76U_nK0Y\"\u003e\r\n    \u003cimg src=\"images/plandex-browser-debug-yt.png\" alt=\"Plandex Browser Debugging Example\" width=\"800\"\u003e\r\n  \u003c/a\u003e\r\n\u003c/div\u003e\r\n\r\n\u003cbr/\u003e\r\n\r\n## Install  📥\r\n\r\n```bash\r\ncurl -sL https://plandex.ai/install.sh | bash\r\n```\r\n\r\n**Note:** Windows is supported via [WSL](https://learn.microsoft.com/en-us/windows/wsl/install). Plandex only works correctly on Windows in the WSL shell. It doesn't work in the Windows CMD prompt or PowerShell.\r\n\r\n[More installation options.](https://docs.plandex.ai/install)\r\n\r\n## Hosting  ⚖️\r\n\r\n| Option                     | Description                                                                                                                                                                                                                                                                                                                                                 |\r\n| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\r\n| **Plandex Cloud**          | Winding down as of 10/3/2025 and no longer accepting new users. \u003ca href=\"https://plandex.ai/blog/winding-down\"\u003eLearn more.\u003c/a\u003e                                                                                                                                                                                                                              |\r\n| **Self-hosted/Local Mode** | • Run Plandex locally with Docker or host on your own server.\u003cbr/\u003e• Use your own [OpenRouter.ai](https://openrouter.ai) key (or [other model provider](https://docs.plandex.ai/models/model-providers) accounts and API keys).\u003cbr/\u003e• Follow the [local-mode quickstart](https://docs.plandex.ai/hosting/self-hosting/local-mode-quickstart) to get started. |\r\n\r\n## Provider keys  🔑\r\n\r\n\u003c!-- If you're going with a 'BYO API Key' option above (whether cloud or self-hosted), you'll need to set API keys for the [model providers](https://docs.plandex.ai/models/model-providers) you're using: --\u003e\r\n\r\n```bash\r\nexport OPENROUTER_API_KEY=... # if using OpenRouter.ai\r\n```\r\n\r\n\u003cbr/\u003e\r\n\r\n## Claude Pro/Max subscription  🖇️\r\n\r\nIf you have a Claude Pro or Max subscription, Plandex can use it when calling Anthropic models. You'll be asked if you want to connect a subscription the first time you run Plandex.\r\n\r\n\u003cbr/\u003e\r\n\r\n## Get started  🚀\r\n\r\nFirst, `cd` into a **project directory** where you want to get something done or chat about the project. Make a new directory first with `mkdir your-project-dir` if you're starting on a new project.\r\n\r\n```bash\r\ncd your-project-dir\r\n```\r\n\r\nFor a new project, you might also want to initialize a git repo. Plandex doesn't require that your project is in a git repo, but it does integrate well with git if you use it.\r\n\r\n```bash\r\ngit init\r\n```\r\n\r\nNow start the Plandex REPL in your project:\r\n\r\n```bash\r\nplandex\r\n```\r\n\r\nor for short:\r\n\r\n```bash\r\npdx\r\n```\r\n\r\n\u003c!-- ☁️ _If you're using Plandex Cloud, you'll be prompted at this point to start a trial._\r\n\r\nThen just give the REPL help text a quick read, and you're ready go. The REPL starts in _chat mode_ by default, which is good for fleshing out ideas before moving to implementation. Once the task is clear, Plandex will prompt you to switch to _tell mode_ to make a detailed plan and start writing code. --\u003e\r\n\r\n\u003cbr/\u003e\r\n\r\n## Docs  🛠️\r\n\r\n### [👉  Full documentation.](https://docs.plandex.ai/)\r\n\r\n\u003cbr/\u003e\r\n\r\n## Discussion and discord  💬\r\n\r\nPlease feel free to give your feedback, ask questions, report a bug, or just hang out:\r\n\r\n- [Discord](https://discord.gg/plandex-ai)\r\n- [Discussions](https://github.com/plandex-ai/plandex/discussions)\r\n- [Issues](https://github.com/plandex-ai/plandex/issues)\r\n\r\n## Follow and subscribe\r\n\r\n- [Follow @PlandexAI](https://x.com/PlandexAI)\r\n- [Follow @Danenania](https://x.com/Danenania) (Plandex's creator)\r\n- [Subscribe on YouTube](https://x.com/PlandexAI)\r\n\r\n\u003cbr/\u003e\r\n\r\n## Contributors  👥\r\n\r\n⭐️  Please star, fork, explore, and contribute to Plandex. There's a lot of work to do and so much that can be improved.\r\n\r\n[Here's an overview on setting up a development environment.](https://docs.plandex.ai/development)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplandex-ai%2Fplandex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplandex-ai%2Fplandex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplandex-ai%2Fplandex/lists"}