Skip to main content
Five minutes. One PR. Whatever agent you already use.
Research Preview — Genie is experimental. Things will break, APIs will change, and we want your feedback. Honest feedback, not polite feedback. Tell us on Discord.
1

Install Genie

Run the bootstrap script (see the full Installation guide for alternatives). It installs the CLI, sets up plugins, and configures git hooks.
Verify the install:
Expected output:
2

Choose Your Agent (or don't — we don't care)

Genie orchestrates agents. It is not an agent. Use whatever you like — we have opinions about orchestration, not about your vendor choices.Claude Code works out of the box. For others, run the setup command and Genie configures the adapter.
You’re never locked in. Switch agents mid-project, mix them on the same team, or write your own adapter. See the adapter docs if you’re the kind of person who builds their own tools.
3

Paste Into Your Agent

Open your agent in your project directory and paste:
Genie detects a fresh project and scaffolds everything:
4

Brainstorm Your First Idea

Got something you want to build? Tell the brainstorm skill about it:
It’ll walk you through the thinking you’d do anyway — but faster:
What’s in, what’s out. The brainstorm skill pushes you to name both edges before you write a line of code.
Dependencies, breaking changes, hidden invariants. If something is load-bearing, it gets called out here instead of surfacing in review.
Approach and tradeoffs. This is the “why this way” that your future self will thank you for.
Is this crisp enough to actually build? If not, the brainstorm keeps probing until it is.
5

Create a Wish

When the brainstorm crystallizes, turn it into something agents can execute:
This produces a WISH.md — the contract between you and your agents:
  • Summary and scope (so nobody wanders off)
  • Acceptance criteria (checkboxes — unambiguous “done”)
  • Execution groups (parallelizable work units)
  • Validation commands (proof it works)
6

Execute and Ship

Let the agents do the work:
When they’re done, validate:
SHIP → PR created. FIX-FIRST → fix loop runs automatically. You don’t babysit either way.

​
What just happened?

You typed four slash commands and got a pull request. Your agent did the actual work. Here’s what it looked like:
Under the hood, Genie tracks every task, board, audit event, and session in an embedded PostgreSQL database. Query it with genie events summary --today or genie task list --by-column for a Kanban view.

​
What’s next

Full onboarding walkthrough

The 15-minute tour — install → smoke test → wizard → first wish → first PR → first monitor.

The Genie Loop

Plan → Review → Work → Ship → Monitor — the canonical lifecycle and the skills behind each phase.

Core Concepts

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

Stuck? Ask on Discord

Real humans. Real answers. Usually within minutes, not days.