automagik-genie

Automagik Genie is a markdown-native agent framework designed to help you orchestrate task work through purpose-built specialists. It stores identity, skills, and memory in your repository as human- and machine-readable markdown notes, enabling portable knowledge that survives provider changes. Use the Genie CLI to launch a terminal UI, spawn agents, and run a guided workflow from brainstorm to ship. Core capabilities include the /dream queue for overnight batch execution, the /brain knowledge vault, the /learn behavior learner, and Council perspectives to surface blind spots before committing to changes. You can also interact with agents directly, spawn specialists for specific roles, and manage tasks, approvals, and deployment gates from within the CLI or the interactive UI. Genie’s workflow emphasizes transparency and human control while automating repetitive or cross-functional tasks through dedicated agents.

To use Genie effectively, install the CLI globally, then start the terminal UI with genie tui. Within the cockpit you can brainstorm ideas, crystallize them into wishes, initiate work through specialized agents, review automated outputs, and ship changes via PRs. For task-specific operations, you can spawn a specialist with genie agent spawn --role fix, or run a council review with genie council "Should we migrate..." to collect multiple expert opinions. Genie integrates with your existing notes and issue tracker, ensuring that every memory and decision remains in your repository for future reference.

Prerequisites:

• Node.js and npm installed on your system
• curl available for the install script (optional if using npm install)

Installation steps:

1. Install Genie globally via npm (preferred for consistent CLI access):

npm install -g @automagik/genie

2. Alternatively, install via the provided install script:

curl -fsSL https://raw.githubusercontent.com/automagik-dev/genie/main/install.sh | bash

3. Verify installation:

genie --version

4. (Optional) If you prefer using npx on demand instead of a global install:

npm install -g

5. Start the terminal UI to begin orchestrating tasks:

genie tui

Prerequisites note: The installer handles prerequisites like tmux, bun, and Claude Code plugin where applicable. Ensure your environment has access to the internet and your shell is configured to run npm and the Genie binary from your PATH.

Notes and tips:

• Genie stores all configuration and knowledge in your repo as markdown files; keep your notes under version control for portability.
• The CLI supports a variety of commands for agent management, task tracking, and execution logging. Use genie help to discover supported commands.
• If you experience issues with agent spawning or council reviews, check your environment for required dependencies (tmux, bun, editor plugins) mentioned in the install notes.
• When running in CI or headless environments, consider using genie daemon for background execution and to keep state consistent across sessions.