genie

Wishes in, PRs out.

Metric	Value
Releases (24h)	2
Merged PRs (7d)	35
Avg merge time	0.3h
SHIP rate	85%

Last updated: 2026-04-06

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.

Get started

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

What you get

  "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 agents do.

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.

Why Genie?

Without Genie Re-explain context every new chat One agent, one file at a time Copy-paste PR descriptions manually Review AI code yourself, line by line Context lost mid-conversation No memory between sessions

With Genie Context captured once, inherited by every agent Parallel agents in isolated worktrees Automated severity-gated code review Queue wishes overnight, wake up to PRs 10-critic council catches what you'd miss Persistent memory across sessions

Skills

17 built-in skills that compose into workflows: