Genie
Wishes in, PRs out. CLI agent that interviews you, plans the work, dispatches parallel agents in isolated worktrees, and reviews code before you see it.
What is Genie?
Genie is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to wishes in, prs out. cli agent that interviews you, plans the work, dispatches parallel agents in isolated worktrees, and reviews code before you see it.
Wishes in, PRs out. CLI agent that interviews you, plans the work, dispatches parallel agents in isolated worktrees, and reviews code before you see it.
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Wishes in, PRs out. CLI agent that interviews you, plans the
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx genieConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Genie
Genie is a CLI agent and skill framework for Claude Code and Codex that automates the full feature-delivery lifecycle: it interviews you about what you want, writes a scoped plan with acceptance criteria, spawns parallel sub-agents in isolated git worktrees, applies severity-gated code review, and opens a pull request for you to review. It ships 17 built-in slash-command skills including /brainstorm, /wish, /work, /review, /fix, /docs, and /pm, and uses a PostgreSQL backend with git-versioned markdown as a persistent memory brain. Developers who want an AI pair programmer that handles planning, parallel execution, and review — not just code completion — use Genie to turn vague wishes into reviewed, ready-to-merge PRs.
Prerequisites
- Claude Code or Codex installed and configured with a valid Anthropic or OpenAI API key
- Git repository initialized in your project directory
- bash or zsh shell on macOS or Linux
- PostgreSQL running locally or accessible remotely (required for v4 state management and persistent memory)
- cosign installed (the Genie installer verifies binary signatures before running)
Install Genie via the install script
Run the one-liner install script. It downloads the Genie binary, verifies it with cosign signatures and SLSA provenance, and installs it on your PATH.
curl -fsSL https://raw.githubusercontent.com/automagik-dev/genie/main/install.sh | bashVerify the installation
Run 'genie doctor' to confirm the binary is installed correctly and all dependencies are detected.
genie doctorRun the onboarding wizard inside Claude Code
Open your project in Claude Code and run the /wizard slash command. This configures Genie's connection to your git repository, PostgreSQL instance, and AI provider.
/wizardLaunch the Genie terminal UI
Run 'genie' to open the interactive terminal UI where you can access all built-in skills and manage active agent sessions.
genieStart a new feature with /wish
Use the /wish skill to describe a feature. Genie will interview you to clarify scope, then generate a plan with acceptance criteria that you can approve before agents start working.
/wish "Add a user authentication flow with email and password login"Execute the plan with parallel agents
Once a plan is approved, use /work to dispatch parallel agents in isolated git worktrees. Each agent works on a separate branch and Genie reviews the results before presenting a PR.
/workGenie Examples
Client configuration
Genie operates as a CLI tool within Claude Code rather than as a standalone MCP server. Register it as an MCP server if you want to expose its tools to other clients.
{
"mcpServers": {
"genie": {
"command": "genie",
"args": ["mcp"]
}
}
}Prompts and slash commands to try
Use these slash commands inside Claude Code or the Genie terminal UI to drive the full development workflow.
- /brainstorm "I want to add real-time notifications to my app — what are my options?"
- /wish "Refactor the database layer to use a repository pattern"
- /work
- /review
- /fix "The login endpoint returns 500 when the email field is empty"
- /docs "Generate API documentation for all public endpoints in src/api"
- /pm "Create a sprint plan for the next two weeks based on the open GitHub issues"Troubleshooting Genie
Install script fails with 'cosign not found' or signature verification error
Install cosign first: 'brew install cosign' on macOS or follow the cosign install guide at https://docs.sigstore.dev/cosign/system_config/installation/. Genie requires signature verification to run the installer for security reasons.
/wizard fails or Genie cannot connect to PostgreSQL
Ensure PostgreSQL is running and accessible. Create a database for Genie ('createdb genie') and ensure your user has connection rights. The /wizard prompt will ask for the connection string — use the format 'postgresql://user:password@localhost:5432/genie'.
Parallel agents in /work fail or produce conflicting changes
Each agent works in an isolated git worktree, so conflicts should not occur during execution. If a worktree is left in a bad state, run 'git worktree list' to see active worktrees and 'git worktree remove <path>' to clean up stale ones. Re-run /work after cleanup.
Frequently Asked Questions about Genie
What is Genie?
Genie is a Model Context Protocol (MCP) server that wishes in, prs out. cli agent that interviews you, plans the work, dispatches parallel agents in isolated worktrees, and reviews code before you see it. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Genie?
Follow the installation instructions on the Genie GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Genie?
Genie works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Genie free to use?
Yes, Genie is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Genie Alternatives — Similar Coding Agents Servers
Looking for alternatives to Genie? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Genie in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Genie?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.