Wishes in, PRs out.
🚀 14 commits this week · 0 releases · -54 LoC · 4 contributors
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.
curl -fsSL https://raw.githubusercontent.com/automagik-dev/genie/main/install.sh | bashEvery release is cosign-signed with SLSA provenance — the installer verifies the binary before it runs.
Then, in Claude Code, Codex, or any AI coding agent, run the onboarding wizard:
/wizard
It interviews you, scaffolds the project, and walks you through your first wish. Prefer the cockpit? genie opens the terminal UI; genie doctor checks your install.
"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 ──────── A council of critics reviews. Severity-tagged. Nothing ships dirty.
|
Pull Request ─── You approve. You merge. Ship it.
Parallel agents. Multiple agents working at once in isolated worktrees. No conflicts, no re-explaining context.
Teams. Spin up a coordinated team of agents — shared mailbox and chat, with native Claude Code teammate UI.
Automated review. A council of specialist critics (architecture, security, DX, performance, ops…) reviews every change. Severity-tagged. CRITICAL blocks the merge.
Overnight mode. /dream — queue wishes before bed, wake up to reviewed PRs.
Persistent memory. A git-versioned knowledge brain — agents search it before answering and write back what they learn, so context compounds instead of resetting every session.
Postgres-backed. Tasks, events, and messages live in PostgreSQL — queryable, durable, real-time via LISTEN/NOTIFY. Your identity, skills, and memory stay as markdown in your repo.
Self-healing. Built-in detectors catch and recover from zombie teams, orphaned sessions, and drift automatically.
Claude or Codex. Bring your own agent — Genie drives either under the hood.
|
|
17 built-in skills that compose into workflows:
| Skill | What it does |
|---|---|
/brainstorm |
Explore vague ideas until they're concrete |
/wish |
Turn an idea into a scoped plan with acceptance criteria |
/work |
Execute a wish with parallel agents |
/review |
Severity-gated code review (SHIP or FIX-FIRST) |
/council |
Multi-agent architectural deliberation (smart-routed) |
/dream |
Batch-execute SHIP-ready wishes overnight |
/trace |
Reproduce, isolate, and root-cause bugs |
/fix |
Minimal targeted bug fixes |
/report |
Deep bug investigation → issue |
/refine |
Turn rough briefs into structured prompts |
/learn |
Correct agent behavior from mistakes |
/docs |
Audit and generate documentation |
/pm |
Full project-management playbook |
/omni |
Wire a Genie agent to an Omni channel |
/genie |
Auto-router — natural language to the right skill |
/genie-hacks |
Community patterns and real-world workflows |
/wizard |
Guided first-run onboarding |
A ground-up rewrite.
| v3 | v4 | |
|---|---|---|
| State | JSON files + NATS | PostgreSQL + LISTEN/NOTIFY (+ git-versioned markdown) |
| UI | CLI only | Full terminal UI |
| Memory | None | Knowledge brain |
| Tasks | Basic | Kanban boards, templates, projects |
| Review | Single pass | Critic-council deliberation |
| Stability | Best effort | Advisory locks, spawn watchdog, self-healing detectors |
A single dark-only palette from one source of truth (packages/genie-tokens/), shared by three consumers (TUI, desktop app, tmux).
Docs · Releases · Discord · MIT License
You describe the problem. Genie does everything else.