genie
Wishes in, PRs out. CLI agent that interviews you, plans the work, dispatches parallel agents in isolated worktrees, and reviews code before you see it.
What is genie?
Wishes in, PRs out. CLI agent that interviews you, plans the work, dispatches parallel agents in isolated worktrees, and reviews code before you see it.
Overview of genie
What it is
Genie is a CLI agent that takes a task description, plans the work, dispatches parallel agents in isolated worktrees, runs the repository's own checks, has an independent agent review the commit, and opens a pull request. It is built with Genie itself: the repository's own designs and plans are stored in .genie/brainstorms and .genie/wishes. Task state lives in one SQLite file per repository (.genie/genie.db) and can be viewed as a kanban board via genie board. Designs, plans and review verdicts are stored as markdown in git under .genie/brainstorms/ and .genie/wishes/.
Key features
- Delivers one task end to end via the
wishskill, returning a pull request ready for the user to merge. - Runs a full loop: brainstorm → design review → wish → plan review → work → implementation review → PR, where every gate is run by an agent that did not do the work.
- Dispatches parallel agents in isolated worktrees for execution.
- Ships 18 skills (v6.261003.1) including authoring, brainstorming, council, docs, fix, merge, refine, research, review, verify, wish, work, and more.
- Ships 12 saved workflows (v6.261003.1) for Claude Code, including brainstorm, council, docs-audit, evidence-gate, wish, workfly, and others.
- Stores all designs, plans, and verdicts in git under
.genie/brainstorms/and.genie/wishes/, and task state in a SQLite database.
Use cases
- Deleting dead code: a single
/wishcommand can remove unused files, move types, and open a PR after independent review. - Planning and executing multi-step changes: bigger tasks go through the full brainstorm → design → wish → work → review loop.
- Auditing documentation, skills, or test files using dedicated workflows (e.g.,
docs-audit,skill-audit-sweep,test-simplify). - Pressure-testing decisions through independent lenses using the
councilskill.
Getting started
bashcurl -fsSL https://raw.githubusercontent.com/automagik-dev/genie/main/install.sh | bash
License and pricing
The license is MIT. The project is open source.
Based on the project's public README and repository metadata.