{"id":35814978,"url":"https://github.com/gemini-cli-extensions/conductor","last_synced_at":"2026-03-11T04:04:31.682Z","repository":{"id":329191379,"uuid":"1117942206","full_name":"gemini-cli-extensions/conductor","owner":"gemini-cli-extensions","description":"Conductor is a Gemini CLI extension that allows you to specify, plan, and implement software features.","archived":false,"fork":false,"pushed_at":"2026-01-07T21:43:13.000Z","size":76,"stargazers_count":1412,"open_issues_count":33,"forks_count":124,"subscribers_count":20,"default_branch":"main","last_synced_at":"2026-01-09T09:50:18.594Z","etag":null,"topics":["context-driven-development","gemini","gemini-cli","gemini-cli-extension","google"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gemini-cli-extensions.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2025-12-17T03:25:48.000Z","updated_at":"2026-01-09T08:27:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gemini-cli-extensions/conductor","commit_stats":null,"previous_names":["gemini-cli-extensions/conductor"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/gemini-cli-extensions/conductor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gemini-cli-extensions%2Fconductor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gemini-cli-extensions%2Fconductor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gemini-cli-extensions%2Fconductor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gemini-cli-extensions%2Fconductor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gemini-cli-extensions","download_url":"https://codeload.github.com/gemini-cli-extensions/conductor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gemini-cli-extensions%2Fconductor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28403750,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T21:51:37.118Z","status":"ssl_error","status_checked_at":"2026-01-13T21:45:14.585Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["context-driven-development","gemini","gemini-cli","gemini-cli-extension","google"],"created_at":"2026-01-07T16:00:43.039Z","updated_at":"2026-02-20T00:05:05.742Z","avatar_url":"https://github.com/gemini-cli-extensions.png","language":null,"readme":"# Conductor Extension for Gemini CLI\n\n**Measure twice, code once.**\n\nConductor is a Gemini CLI extension that enables **Context-Driven Development**. It turns the Gemini CLI into a proactive project manager that follows a strict protocol to specify, plan, and implement software features and bug fixes.\n\nInstead of just writing code, Conductor ensures a consistent, high-quality lifecycle for every task: **Context -\u003e Spec \u0026 Plan -\u003e Implement**.\n\nThe philosophy behind Conductor is simple: control your code. By treating context as a managed artifact alongside your code, you transform your repository into a single source of truth that drives every agent interaction with deep, persistent project awareness.\n\n## Features\n\n- **Plan before you build**: Create specs and plans that guide the agent for new and existing codebases.\n- **Maintain context**: Ensure AI follows style guides, tech stack choices, and product goals.\n- **Iterate safely**: Review plans before code is written, keeping you firmly in the loop.\n- **Work as a team**: Set project-level context for your product, tech stack, and workflow preferences that become a shared foundation for your team.\n- **Build on existing projects**: Intelligent initialization for both new (Greenfield) and existing (Brownfield) projects.\n- **Smart revert**: A git-aware revert command that understands logical units of work (tracks, phases, tasks) rather than just commit hashes.\n\n## Installation\n\nInstall the Conductor extension by running the following command from your terminal:\n\n```bash\ngemini extensions install https://github.com/gemini-cli-extensions/conductor --auto-update\n```\n\nThe `--auto-update` is optional: if specified, it will update to new versions as they are released.\n\n## Usage\n\nConductor is designed to manage the entire lifecycle of your development tasks.\n\n**Note on Token Consumption:** Conductor's context-driven approach involves reading and analyzing your project's context, specifications, and plans. This can lead to increased token consumption, especially in larger projects or during extensive planning and implementation phases. You can check the token consumption in the current session by running `/stats model`.\n\n\u003e [!WARNING]\n\u003e **Disable Gemini CLI's built-in Plan Mode for Conductor**\n\u003e Conductor manages its own planning lifecycle. Gemini CLI's built-in Plan Mode will conflict with Conductor's state management. For the best Conductor experience, please disable Gemini CLI's built-in Plan Mode in your environment.\n\n### 1. Set Up the Project (Run Once)\n\nWhen you run `/conductor:setup`, Conductor helps you define the core components of your project context. This context is then used for building new components or features by you or anyone on your team.\n\n- **Product**: Define project context (e.g. users, product goals, high-level features).\n- **Product guidelines**: Define standards (e.g. prose style, brand messaging, visual identity).\n- **Tech stack**: Configure technical preferences (e.g. language, database, frameworks).\n- **Workflow**: Set team preferences (e.g. TDD, commit strategy). Uses [workflow.md](templates/workflow.md) as a customizable template.\n\n**Generated Artifacts:**\n- `conductor/product.md`\n- `conductor/product-guidelines.md`\n- `conductor/tech-stack.md`\n- `conductor/workflow.md`\n- `conductor/code_styleguides/`\n- `conductor/tracks.md`\n\n```bash\n/conductor:setup\n```\n\n### 2. Start a New Track (Feature or Bug)\n\nWhen you’re ready to take on a new feature or bug fix, run `/conductor:newTrack`. This initializes a **track** — a high-level unit of work. Conductor helps you generate two critical artifacts:\n\n- **Specs**: The detailed requirements for the specific job. What are we building and why?\n- **Plan**: An actionable to-do list containing phases, tasks, and sub-tasks.\n\n**Generated Artifacts:**\n- `conductor/tracks/\u003ctrack_id\u003e/spec.md`\n- `conductor/tracks/\u003ctrack_id\u003e/plan.md`\n- `conductor/tracks/\u003ctrack_id\u003e/metadata.json`\n\n```bash\n/conductor:newTrack\n# OR with a description\n/conductor:newTrack \"Add a dark mode toggle to the settings page\"\n```\n\n### 3. Implement the Track\n\nOnce you approve the plan, run `/conductor:implement`. Your coding agent then works through the `plan.md` file, checking off tasks as it completes them.\n\n**Updated Artifacts:**\n- `conductor/tracks.md` (Status updates)\n- `conductor/tracks/\u003ctrack_id\u003e/plan.md` (Status updates)\n- Project context files (Synchronized on completion)\n\n```bash\n/conductor:implement\n```\n\nConductor will:\n1.  Select the next pending task.\n2.  Follow the defined workflow (e.g., TDD: Write Test -\u003e Fail -\u003e Implement -\u003e Pass).\n3.  Update the status in the plan as it progresses.\n4.  **Verify Progress**: Guide you through a manual verification step at the end of each phase to ensure everything works as expected.\n\nDuring implementation, you can also:\n\n- **Check status**: Get a high-level overview of your project's progress.\n  ```bash\n  /conductor:status\n  ```\n- **Revert work**: Undo a feature or a specific task if needed.\n  ```bash\n  /conductor:revert\n  ```\n\n- **Review work**: Review completed work against guidelines and the plan.\n  ```bash\n  /conductor:review\n  ```\n\n## Commands Reference\n\n| Command | Description | Artifacts |\n| :--- | :--- | :--- |\n| `/conductor:setup` | Scaffolds the project and sets up the Conductor environment. Run this once per project. | `conductor/product.md`\u003cbr\u003e`conductor/product-guidelines.md`\u003cbr\u003e`conductor/tech-stack.md`\u003cbr\u003e`conductor/workflow.md`\u003cbr\u003e`conductor/tracks.md` |\n| `/conductor:newTrack` | Starts a new feature or bug track. Generates `spec.md` and `plan.md`. | `conductor/tracks/\u003cid\u003e/spec.md`\u003cbr\u003e`conductor/tracks/\u003cid\u003e/plan.md`\u003cbr\u003e`conductor/tracks.md` |\n| `/conductor:implement` | Executes the tasks defined in the current track's plan. | `conductor/tracks.md`\u003cbr\u003e`conductor/tracks/\u003cid\u003e/plan.md` |\n| `/conductor:status` | Displays the current progress of the tracks file and active tracks. | Reads `conductor/tracks.md` |\n| `/conductor:revert` | Reverts a track, phase, or task by analyzing git history. | Reverts git history |\n| `/conductor:review` | Reviews completed work against guidelines and the plan. | Reads `plan.md`, `product-guidelines.md` |\n\n## Resources\n\n- [Gemini CLI extensions](https://geminicli.com/docs/extensions/): Documentation about using extensions in Gemini CLI\n- [GitHub issues](https://github.com/gemini-cli-extensions/conductor/issues): Report bugs or request features\n\n## Legal\n\n- License: [Apache License 2.0](LICENSE)\n","funding_links":[],"categories":["Others",":tada: New","Configuration \u0026 Rules"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgemini-cli-extensions%2Fconductor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgemini-cli-extensions%2Fconductor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgemini-cli-extensions%2Fconductor/lists"}