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.

Genie isn’t one big feature — it’s a set of small, composable capabilities that turn “AI can code” into “AI can ship.” Each one solves a specific coordination problem. Together, they become a coherent orchestration layer.

Wishes — Structured Intent

Define what to build once — scope, acceptance criteria, execution groups — and never re-explain it to another agent.

Pipeline — Brainstorm to Ship

Seven stages from vague idea to merged PR: draft, brainstorm, wish, build, review, qa, ship. Each stage has a skill and a gate.

Team Orchestration

Multi-agent squads with isolated worktrees, shared state, and dependency-aware scheduling. Parallel execution without merge conflicts.

PostgreSQL Backend

Embedded pgserve database with 10 migrations — tasks, boards, agents, sessions, audit events, and app registry. All state in PG, not JSON files.

Board & Pipeline System

Kanban-style boards with configurable columns, gate types, and action skills. Project-scoped pipelines that drive the task lifecycle.

OTel Observability

Full event audit log, cost breakdown by agent/model/wish, tool usage analytics, session replay, and machine metrics. All queryable from the CLI.

Real-time Coordination

Cross-agent messaging so agents know what each other are doing. Durable mailboxes, team chat, and tmux pane injection.

Context Preservation

Provider-agnostic transcript capture across Claude and Codex. Session history survives crashes, suspends, and provider switches.

Skills + /pm

Composable slash commands — from /brainstorm through /dream, plus a full /pm playbook. Each one encodes a workflow we got tired of repeating manually.

Item Registry

Unified app store for agents, skills, boards, workflows, stacks, templates, and hooks. Install, version, and manage ecosystem items.

Provider Agnosticism — BYOA

Claude, Codex, Open Claw, or your custom agent. Mix providers on the same team. Genie cares that the work ships — not who does it.

Notification System

Per-actor notification preferences across WhatsApp, Slack, email, and more. PostgreSQL LISTEN/NOTIFY for real-time event streaming.

What’s next

Install the CLI

Get Genie running on Linux or macOS — npm, Bun, Homebrew, or the one-line bootstrap.

Quickstart

Five-minute smoke test from install to your first merged PR.

The Genie Loop

Plan → Review → Work → Ship → Monitor — the canonical lifecycle that ties these features together.

Core Concepts

The primitives — wishes, agents, teams, skills — that power every feature above.