Wishes in, PRs out.

🚀 117 commits this week · 6 releases · +22.7K LoC · 6 contributors

📊 Full velocity dashboard →

Genie is a CLI that turns one sentence into a finished pull request. You describe what you want — Genie interviews you, writes a plan, spawns parallel agents in isolated worktrees, reviews the code, and opens a PR. You approve. You merge. That's it.

Paste this into Claude Code, Codex, or any AI coding agent:

Install Genie and set up this project:

curl -fsSL https://raw.githubusercontent.com/automagik-dev/genie/main/install.sh | bash
genie
/wizard

That's it. The wizard interviews you, scaffolds your project, and walks you through your first wish. Relax.

Or install manually:

curl -fsSL https://raw.githubusercontent.com/automagik-dev/genie/main/install.sh | bash

  "Add dark mode"
       |
   /brainstorm ──── Genie asks questions until the idea is concrete
       |
   /wish ────────── Turns it into a plan: scope, criteria, task groups
       |
   /work ────────── Agents spawn in parallel worktrees, each on its own branch
       |
   /review ──────── 10 critics review. Severity-tagged. Nothing ships dirty.
       |
   Pull Request ─── You approve. You merge. Ship it.

Parallel agents. Not one agent doing everything sequentially — multiple agents working at the same time in isolated worktrees. No conflicts. No re-explaining context.

Automated review. A 10-critic council (architecture, security, DX, performance, ops, and more) reviews every design before you see it. Severity-tagged findings. CRITICAL blocks the PR.

Overnight mode. /dream — queue wishes before bed. Wake up to reviewed PRs.

Kanban boards. Built-in task boards with custom pipelines and stage gates.

Postgres-backed. All state lives in PostgreSQL — agents, tasks, events, messages. Queryable. Durable. Real-time via LISTEN/NOTIFY.

Full observability. Events, metrics, session replay, cost tracking. See everything your genie-spawned agents do — OTel-derived tool, cost, and API-request rows only cover sessions launched via genie spawn / genie team create; user-initiated Claude Code sessions are captured only when they export the OTLP env themselves.

Portable context. Identity, skills, memory — all markdown files in your repo, git-versioned. You own everything.

Any AI provider. Claude, Codex, or any OpenAI-compatible model. Bring your own agent.

17 built-in skills that compose into workflows:

v4 is a ground-up rewrite. 700 commits. 300 files. ~19K lines.

Full v4 release notes →

Structured event emission, signed subscription tokens, 4-tier retention, and an external dead-man's switch. Consumer-compat promises are published at docs/observability-contract.md; the 5-phase rollout plan at docs/observability-rollout.md.

External consumers (e.g. the omni scope-enforcer) can query ground-truth turn state directly from genie serve. Two paths are supported:

HTTP — GET http://127.0.0.1:<port>/executors/:id/state returns {state, outcome, closed_at} as JSON. The default port is pgserve_port + 2; override with GENIE_EXECUTOR_READ_PORT. Returns 404 for unknown IDs, 400 for non-UUID IDs, 200 otherwise. No authz — executor IDs are random UUIDs and the view exposes no secrets.

Direct SQL — connect to genie-PG as the read-only executors_reader role and SELECT state, outcome, closed_at FROM executors_public_state WHERE id = $1. Layer login credentials on top:

CREATE ROLE omni_scope_enforcer LOGIN PASSWORD '…' IN ROLE executors_reader;

Response shape (state / outcome / closed_at) is the stable boundary contract; removing or renaming fields is a coordinated breaking change.

Docs · v4 Release · Discord · MIT License

_{You describe the problem. Genie does everything else.}