# Automagik

## Docs

- [Messaging & Routing](https://docs.automagik.dev/genie/architecture/messaging.md): NATS pub/sub, protocol router, and Claude Code native teams bridge
- [Architecture Overview](https://docs.automagik.dev/genie/architecture/overview.md): How Genie v4 components connect — from CLI to database to agents
- [PostgreSQL (pgserve)](https://docs.automagik.dev/genie/architecture/postgres.md): Embedded PostgreSQL database, migrations, and the task service
- [Scheduler](https://docs.automagik.dev/genie/architecture/scheduler.md): The scheduler daemon — cron triggers, lease-based claiming, heartbeats, and orphan reconciliation
- [State Management](https://docs.automagik.dev/genie/architecture/state.md): Wish state machine, agent registry, teams, mailbox, team chat, boards, and projects
- [Transcripts](https://docs.automagik.dev/genie/architecture/transcripts.md): Provider-agnostic log parsing for Claude Code and Codex sessions
- [Agents](https://docs.automagik.dev/genie/cli/agents.md): Agent lifecycle commands — spawn, kill, stop, resume, ls, history, read, answer. For register, see Directory.
- [Boards](https://docs.automagik.dev/genie/cli/boards.md): Board and pipeline management — create, configure, and manage Kanban-style boards
- [Database](https://docs.automagik.dev/genie/cli/database.md): Database management — check health, run migrations, and execute SQL queries via pgserve
- [Directory](https://docs.automagik.dev/genie/cli/directory.md): Agent directory CRUD — add, remove, list, and edit agent registrations.
- [Dispatch](https://docs.automagik.dev/genie/cli/dispatch.md): Context-injecting dispatch commands — brainstorm, wish, work, review, done, reset, status.
- [Export & Import](https://docs.automagik.dev/genie/cli/export-import.md): Back up, migrate, and restore Genie data as schema-versioned JSON.
- [Infrastructure](https://docs.automagik.dev/genie/cli/infrastructure.md): Setup, TUI, app, serve, diagnostics, updates, database management, and terminal shortcuts.
- [Messaging](https://docs.automagik.dev/genie/cli/messaging.md): Agent communication — send, broadcast, inbox, chat.
- [Observability](https://docs.automagik.dev/genie/cli/observability.md): Events, sessions, metrics, schedules, QA, log feed, and brief — monitor everything happening in your Genie system
- [Projects](https://docs.automagik.dev/genie/cli/projects.md): Project management — named task boards for multi-repo organization
- [Item Registry](https://docs.automagik.dev/genie/cli/registry.md): Install, publish, update, and manage reusable Genie items — agents, skills, apps, boards, workflows, stacks, templates, and hooks
- [Releases, Tags & Types](https://docs.automagik.dev/genie/cli/releases-tags-types.md): Manage releases, custom tags, and task type pipelines
- [Scheduling & Notifications](https://docs.automagik.dev/genie/cli/scheduling.md): Manage scheduled triggers, the scheduler daemon, and notification preferences
- [Session](https://docs.automagik.dev/genie/cli/session.md): Start and manage Genie sessions — genie, genie --session
- [Spawn & Lifecycle](https://docs.automagik.dev/genie/cli/spawn.md): Spawn agents, stop, resume, and force-kill — the full agent process lifecycle
- [Tasks](https://docs.automagik.dev/genie/cli/tasks.md): Task lifecycle management — create, list, move, assign, block, and track work items
- [Team](https://docs.automagik.dev/genie/cli/team.md): Team lifecycle management — create, hire, fire, list, and disband teams.
- [Agents](https://docs.automagik.dev/genie/concepts/agents.md): Autonomous agents with identities, roles, and lifecycle management.
- [Boards](https://docs.automagik.dev/genie/concepts/boards.md): Kanban-style pipeline boards for visualizing and managing task flow.
- [Bring Your Own Agent](https://docs.automagik.dev/genie/concepts/byoa.md): Use any AI coding agent with Genie — Claude Code, Codex, Gemini CLI, Open Claw, or your own custom agent.
- [Projects](https://docs.automagik.dev/genie/concepts/projects.md): Named task containers that scope work to specific initiatives.
- [Skills](https://docs.automagik.dev/genie/concepts/skills.md): Slash-command prompt programs that encode best practices into reusable workflows.
- [Teams](https://docs.automagik.dev/genie/concepts/teams.md): Multi-agent squads that coordinate through worktrees, messaging, and shared state.
- [Wishes](https://docs.automagik.dev/genie/concepts/wishes.md): The structured plan that drives everything — from brainstorm to pull request.
- [Configuration Files](https://docs.automagik.dev/genie/config/files.md): config.json schema, PostgreSQL state, environment variables, and auto-approve configuration
- [Hooks](https://docs.automagik.dev/genie/config/hooks.md): Hook system — auto-spawn, identity injection, NATS emit, and branch guards
- [Setup Wizard](https://docs.automagik.dev/genie/config/setup.md): Interactive setup wizard walkthrough for configuring Genie
- [tmux Integration](https://docs.automagik.dev/genie/config/tmux.md): Sessions, windows, panes, keyboard shortcuts, and agent transport
- [Worktrees & Isolation](https://docs.automagik.dev/genie/config/worktrees.md): Git clone --shared isolation, worktree paths, and cleanup
- [Contributing](https://docs.automagik.dev/genie/contributing.md): Development setup, code style, quality gates, and plugin development
- [Features](https://docs.automagik.dev/genie/features.md): The capabilities that make Genie work — from structured intent to provider-agnostic orchestration.
- [Genie Hacks](https://docs.automagik.dev/genie/hacks.md): Patterns from people who actually use this thing. Tested, opinionated, no fluff.
- [CanisterWorm Incident Response](https://docs.automagik.dev/genie/incident-response/canisterworm.md): Public incident-response runbook for the @automagik/genie + pgserve npm supply-chain compromise of 2026-04-21 / 2026-04-22.
- [What is Genie?](https://docs.automagik.dev/genie/index.md): You shouldn't be the orchestration layer. Genie is.
- [Installation](https://docs.automagik.dev/genie/installation.md): Install Genie CLI, configure prerequisites, and verify your setup.
- [Detectors](https://docs.automagik.dev/genie/observability/detectors.md): Stream rot/detector events to catch state drift, orphaned executors, and session-reuse ghosts in real time.
- [Onboarding](https://docs.automagik.dev/genie/onboarding.md): The first 15 minutes — install, smoke test, first wish, first PR, first monitor.
- [Quickstart](https://docs.automagik.dev/genie/quickstart.md): Five minutes from nothing to your first PR. Bring whatever agent you like — we're not picky.
- [Distribution Sovereignty](https://docs.automagik.dev/genie/security/distribution-sovereignty.md): Why Genie ships through its own signed CDN instead of relying on npmjs.com — the threat model, the verification flow, and the soft-deprecate path for the npm channel.
- [Security & Trust](https://docs.automagik.dev/genie/security/index.md): How Genie is signed, distributed, and verified — the trust contract operators inherit at install time.
- [Signing-Identity Rotation](https://docs.automagik.dev/genie/security/key-rotation.md): When and how to rotate the cosign certificate identity that operators verify against — and what stays unchanged in routine releases.
- [Verifying Installs](https://docs.automagik.dev/genie/security/verifying-installs.md): Step-by-step walkthrough of `genie sec verify-install`, what each verification stage proves, and how to manually cross-check the four pinning channels.
- [/brain](https://docs.automagik.dev/genie/skills/brain.md): Knowledge graph engine — search, analyze, and manage AI agent brains with confidence scoring, autoschema, and multimodal support.
- [/brainstorm](https://docs.automagik.dev/genie/skills/brainstorm.md): Explore ambiguous or early-stage ideas interactively — tracks wish-readiness and crystallizes into a design for /wish.
- [/council](https://docs.automagik.dev/genie/skills/council.md): Convene real AI agents for multi-perspective deliberation on architecture, design, and strategy decisions.
- [/docs](https://docs.automagik.dev/genie/skills/docs.md): Dispatch docs subagent to audit, generate, and validate documentation against the codebase.
- [/dream](https://docs.automagik.dev/genie/skills/dream.md): Batch-execute SHIP-ready wishes overnight — pick wishes, orchestrate workers, review PRs, wake up to results.
- [/fix](https://docs.automagik.dev/genie/skills/fix.md): Dispatch fix subagent for FIX-FIRST gaps from /review, re-review, and escalate after 2 failed loops.
- [/genie](https://docs.automagik.dev/genie/skills/genie.md): Single entry point for all genie operations — auto-routes natural language to the right skill, detects lifecycle state, handles operational commands.
- [/genie-hacks](https://docs.automagik.dev/genie/skills/genie-hacks.md): Browse, search, and contribute community hacks — real-world patterns for provider switching, teams, skills, hooks, cost optimization, and more.
- [/learn](https://docs.automagik.dev/genie/skills/learn.md): Diagnose and fix agent behavioral surfaces when the user corrects a mistake — connects to Claude native memory.
- [The Genie Loop](https://docs.automagik.dev/genie/skills/loop-overview.md): Plan → Review → Work → Ship → Monitor — the canonical lifecycle
- [/pm](https://docs.automagik.dev/genie/skills/pm.md): Full PM playbook — triage backlog, prioritize, assign, track, report, escalate. Copilot, autopilot, or pair modes.
- [/refine](https://docs.automagik.dev/genie/skills/refine.md): Transform a brief or prompt into a structured, production-ready prompt via prompt-optimizer. File or text mode.
- [/report](https://docs.automagik.dev/genie/skills/report.md): Investigate bugs comprehensively — cascade through /trace, capture browser evidence, extract observability data, and auto-create a GitHub issue.
- [/review](https://docs.automagik.dev/genie/skills/review.md): Validate plans, execution, or PRs against wish criteria — returns SHIP / FIX-FIRST / BLOCKED with severity-tagged gaps.
- [/trace](https://docs.automagik.dev/genie/skills/trace.md): Dispatch trace subagent to investigate unknown issues — reproduces, traces, and reports root cause for /fix handoff.
- [/wish](https://docs.automagik.dev/genie/skills/wish.md): Convert an idea into a structured wish plan with scope, acceptance criteria, and execution groups for /work.
- [/wizard](https://docs.automagik.dev/genie/skills/wizard.md): Guided onboarding — scaffold workspace, shape agent identity, create first wish, execute, and celebrate.
- [/work](https://docs.automagik.dev/genie/skills/work.md): Execute an approved wish plan — orchestrate subagents per task group with fix loops, validation, and review handoff.
- [Media Processing](https://docs.automagik.dev/omni/architecture/media.md): Media pipeline architecture — transcription, image description, document extraction, circuit breaker, and batch processing.
- [Voice Gateway](https://docs.automagik.dev/omni/architecture/voice.md): Bun-native Discord voice client with DAVE end-to-end encryption — join channels, stream audio, debug sessions.
- [Agents & Providers](https://docs.automagik.dev/omni/cli/agents.md): AI agent management, provider configuration, routing rules, and API keys.
- [Automations](https://docs.automagik.dev/omni/cli/automations.md): Create event-driven automations — trigger actions on messages, events, and custom conditions.
- [Debug & Operations](https://docs.automagik.dev/omni/cli/debug.md): Hidden debug commands for troubleshooting Omni — dead letters, payloads, and system logs.
- [Events & Analytics](https://docs.automagik.dev/omni/cli/events.md): Query events, search content, view timelines, replay sessions, and analyze messaging metrics.
- [Management](https://docs.automagik.dev/omni/cli/management.md): Instance management, automations, access control, webhooks, and contact directory.
- [Messaging](https://docs.automagik.dev/omni/cli/messaging.md): Send messages, manage chats, search messages, handle media — the core Omni commands.
- [Providers](https://docs.automagik.dev/omni/cli/providers.md): Manage AI and agent providers — create, configure, test, and connect to Agno, OpenClaw, Claude Code, Genie, and more.
- [Routes, Persons & Auth](https://docs.automagik.dev/omni/cli/routes-persons-auth.md): Agent routing, person directory, authentication, and API key management.
- [System](https://docs.automagik.dev/omni/cli/system.md): Configuration, events, batch processing, prompts, diagnostics, and service management.
- [TTS, Batch & Prompts](https://docs.automagik.dev/omni/cli/tts-batch-prompts.md): Text-to-speech voices, batch media processing, and LLM prompt overrides
- [Webhooks](https://docs.automagik.dev/omni/cli/webhooks.md): Manage webhook event sources — create endpoints, validate headers, and trigger custom events.
- [AI Agent Integration](https://docs.automagik.dev/omni/concepts/agents.md): Bind AI agents to channels with providers, routing rules, and reply filters.
- [Instances](https://docs.automagik.dev/omni/concepts/instances.md): Channel connections — WhatsApp, Discord, Telegram, Slack lifecycle, QR pairing, and sync.
- [Routes](https://docs.automagik.dev/omni/concepts/routes.md): Agent routing with per-user and per-chat overrides — how messages reach the right AI agent.
- [What is Omni?](https://docs.automagik.dev/omni/index.md): Unified messaging platform for WhatsApp, Telegram, Discord, and Slack — with AI agent routing and event-driven automations.
- [Quickstart](https://docs.automagik.dev/omni/quickstart.md): From zero to your first message in 5 minutes — install, connect, send.
- [Batch Mode](https://docs.automagik.dev/rlmx/batch.md): Bulk interrogation with caching, cost estimation, and the Gemini Batch API.
- [Cache Mode (CAG)](https://docs.automagik.dev/rlmx/cache.md): Cache-Augmented Generation — bake full context into the system prompt and lean on provider-level prompt caching for 50–95% discounts.
- [CLI Reference](https://docs.automagik.dev/rlmx/cli/reference.md): Complete reference for all RLMX commands, flags, and output modes.
- [Configuration](https://docs.automagik.dev/rlmx/config.md): .rlmx/ directory layout, rlmx.yaml format, config commands, and settings priority.
- [RLMX](https://docs.automagik.dev/rlmx/index.md): RLM algorithm CLI for coding agents — prompt externalization, iterative REPL execution, and recursive sub-calls.
- [Quickstart](https://docs.automagik.dev/rlmx/quickstart.md): Install RLMX and run your first query in under five minutes.

## OpenAPI Specs

- [openapi](https://docs.automagik.dev/api-reference/openapi.json)