Summary

Genie is a CLI agent designed to automate the transformation of vague development ideas into shipped Pull Requests. It targets developers overwhelmed by context-switching or repetitive explanations to AI, offering a structured pipeline from initial description to automated code review, thereby streamlining workflows and ensuring consistent output.

How It Works

Genie employs a "Wish Pipeline" starting with user input (/wish), followed by an interview to clarify context and define acceptance criteria. Specialized agents then execute tasks in parallel within isolated terminal sessions (worktrees), preserving context and leveraging persistent memory. An automated review stage flags critical issues before PR creation, ensuring code quality. The system aims for behavioral learning to adapt to specific codebases and user preferences.

Quick Start & Requirements

Installation is via a bash script (curl -fsSL https://raw.githubusercontent.com/automagik-dev/genie/main/install.sh | bash), which installs Bun, tmux, and the Claude Code plugin. An alternative npm install -g @automagik/genie requires manual setup of Bun (v1.3.10+), tmux, and genie setup. Requires macOS or Linux.

Highlighted Details

• Wish Pipeline: Orchestrates Brainstorm, Wish, Work, Review, and Ship stages.
• Parallel Agents: Execute tasks concurrently in live terminal sessions.
• Context Preservation: Uses scoped specialists and persistent memory.
• Automated Review: Implements severity-gated reviews before PR creation.
• Overnight Execution: Allows queuing tasks for completion during sleep.
• 10-Critic Council: Design critique mechanism involving multiple AI specialists.
• Behavioral Learning: Adapts to codebase conventions.

Maintenance & Community

Project hosted on GitHub (automagik-dev/genie) with a Discord community link provided. No specific maintenance activity or contributor details are highlighted in the README.

Licensing & Compatibility

Released under the MIT License, which is permissive for commercial use and integration with closed-source projects.

Limitations & Caveats

Genie is a CLI-only tool restricted to macOS and Linux. It has dependencies on Bun and tmux, and integrates with Claude Code. While it automates development tasks, user approval remains necessary for shipping, positioning it as an advanced assistant rather than a fully autonomous system.