Quick Start

# Navigate to your project
cd my-project

# Initialize Genie workspace
genie init

# This creates:
# - .genie/ directory
# - config.json
# - workflow templates

{
  "mcp": {
    "enabled": true,
    "port": 3000
  },
  "agents": {
    "coder": {
      "enabled": true,
      "llm": "claude",
      "model": "claude-3-5-sonnet-20241022"
    },
    "reviewer": {
      "enabled": true,
      "llm": "claude"
    }
  },
  "llms": {
    "claude": {
      "apiKey": "sk-ant-your-key-here"
    }
  },
  "repository": {
    "autoIndex": true,
    "excludePaths": ["node_modules", ".git", "dist"]
  }
}

# Index repository
genie index

# This analyzes:
# - File structure
# - Code patterns
# - Dependencies
# - Documentation

# You should see:
# ✓ Repository indexed
# ✓ 247 files analyzed
# ✓ Context ready for agents

# Make a wish (what you want to build)
genie wish "Add user authentication with JWT tokens"

# Genie creates:
# - wishes/add-user-authentication.md
# - Detailed specification
# - Implementation plan

# Genie plans the implementation
genie plan wishes/add-user-authentication.md

# Output shows:
# Plan: Add User Authentication
#
# Steps:
# 1. Create auth middleware
# 2. Add JWT token generation
# 3. Add login endpoint
# 4. Add signup endpoint
# 5. Add authentication tests
#
# Estimated time: 2-3 hours

# Forge the implementation
genie forge wishes/add-user-authentication.md

# Progress:
# ⚡ Forging: Add user authentication
# ✓ Step 1/5: Create auth middleware (2 min)
# ✓ Step 2/5: Add JWT token generation (3 min)
# ✓ Step 3/5: Add login endpoint (2 min)
# ✓ Step 4/5: Add signup endpoint (2 min)
# ✓ Step 5/5: Add authentication tests (4 min)
#
# ✓ Implementation complete!

# Review the implementation
genie review wishes/add-user-authentication.md

# Genie's reviewer agent checks:
# - Code quality
# - Security issues
# - Test coverage
# - Documentation

# Review Report:
# ✓ Code quality: Excellent
# ⚠ Security: Add rate limiting to login
# ✓ Test coverage: 94%
# ✓ Documentation: Complete

# Start Genie MCP server
genie serve --mcp

# Server starts on port 3000
# Available tools:
# - genie_analyze_repo
# - genie_make_wish
# - genie_plan
# - genie_forge
# - genie_review

{
  "mcpServers": {
    "genie": {
      "command": "genie",
      "args": ["serve", "--mcp"]
    }
  }
}

You: "Use Genie to add a search feature to my project"

Claude: I'll use Genie to plan and implement a search feature.

[Uses genie_make_wish]
[Uses genie_plan]
[Uses genie_forge]

✓ Search feature implementation complete!

# Create from template
genie template create my-api --from express-api

# Sync with latest template
genie template sync my-api

# List available templates
genie template list

# Create custom template
genie template save my-api --name my-custom-template

# View learned patterns
genie patterns

# Patterns detected:
# - You prefer async/await over promises
# - You use TypeScript strict mode
# - You follow Conventional Commits
# - You write tests with Jest

# Genie applies these patterns automatically in future work!