genie
automagik-dev/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.
Instalação
npx convez-ai automagik-dev/genie1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
🚀 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.
Install
curl -fsSL https://raw.githubusercontent.com/automagik-dev/genie/main/install.sh | bash
Every 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.
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 ──────── 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.
Why Genie?
Without Genie
- Re-explain context every new chat
- One agent, one file at a time
- Copy-paste PR descriptions by hand
- Review AI code yourself, line by line
- No memory between sessions
With Genie
- Context captured once, inherited by every agent
- Parallel agents in isolated worktrees
- Automated severity-gated review
- Queue wishes overnight, wake to PRs
- Persistent memory across sessions
Skills
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 |
What's new in v4
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 |
Design
A single dark-only palette from one source of truth (packages/genie-tokens/), shared by three consumers (TUI, desktop app, tmux).