Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.automagik.dev/llms.txt

Use this file to discover all available pages before exploring further.

This is the 15-minute walkthrough. If you want the 60-second smoke test, jump to the Quickstart. If you want to be narrated through step-by-step inside your agent, run /wizard — same flow, inline.
The first 15 minutes with Genie, end to end. You’ll install the CLI, smoke-test it, run your first wish, open your first PR, and check your first monitor.
1

Install the CLI

Run the bootstrap script. See Installation for manual / Homebrew / source paths.
curl -fsSL https://raw.githubusercontent.com/automagik-dev/genie/main/install.sh | bash
Verify:
genie doctor
2

Smoke test it

Open your agent in a project directory and run:
genie
Genie scaffolds .genie/, AGENTS.md, and git hooks on a fresh repo. Confirmation output should mention the scaffolding it performed. See Quickstart for the full expected terminal output.
3

Run the wizard

/wizard is the guided tour through your first Genie session — five phases from environment check to your first merged PR. It calls the right loop skill at each step, so you get to see the whole loop in action without memorizing skill names first.
/wizard
If you close your agent halfway through, the next /wizard invocation picks up where you left off.
4

Your first wish

When the wizard asks “What’s the first thing you’d like to build or fix?”, pick something concrete. A good first wish is small, self-contained, and observable.
Add a dark mode toggle to the settings page
The wizard routes you through /brainstorm (if the idea needs sharpening) and then /wish to produce a WISH.md — scope, acceptance criteria, execution groups.
5

Review and ship

/review gates the wish. A SHIP verdict means the plan is clear enough to execute. Then /work dispatches agents per execution group and opens a pull request targeting dev when everything lands.If review returns FIX-FIRST, /fix closes the gaps automatically — max two loops before escalation.
6

Monitor what you shipped

Once the PR is open, keep an eye on progress:
genie status <wish-slug>            # progress per group
genie events list --since 10m        # recent activity across all agents
For long-running work or multiple parallel wishes, /pm is the playbook — copilot, autopilot, and pair modes for orchestrating a backlog.

​
If something breaks

Gate flagged FIX-FIRST

The fix skill applies severity-tagged gap lists and re-reviews automatically. Two loops max.

Agent went silent

genie ls shows agent status. genie kill <name> and genie resume <name> handle stuck or crashed agents.

​
What’s next

The Genie Loop

The canonical plan → review → work → ship → monitor lifecycle.

Core concepts

Understand wishes, agents, teams, and skills in depth.