AI Magicx CLI

# Start the TUI (opens provider connect if not authenticated)
aimagicx

# With a specific model
aimagicx chat -m gpt-4o

# Resume a previous session
aimagicx -r <session-id>

# One-shot prompt
aimagicx chat -p "Explain this codebase"

# Login with API key
aimagicx auth login
aimagicx auth login --provider anthropic

# Check auth status
aimagicx auth status

# Logout
aimagicx auth logout
aimagicx auth logout --provider openai

# Start interactive chat
aimagicx chat

# Use specific model
aimagicx chat -m claude-sonnet-4-20250514

# Resume previous session
aimagicx chat -r <session-id>

# Set approval mode
aimagicx chat -a read-only    # Read-only mode (exploration only)
aimagicx chat -a auto         # Auto mode (default)
aimagicx chat -a full         # Full mode (auto-approve all)
aimagicx chat --yolo          # Alias for --approval-mode full

# Headless mode (for automation/scripts)
aimagicx chat -p "Fix the bug" --headless

# List configured providers
aimagicx provider list

# Show available presets
aimagicx provider presets

# Add provider from preset
aimagicx provider add anthropic --preset anthropic

# Add custom provider
aimagicx provider add my-provider \
  --endpoint https://api.example.com/v1 \
  --protocol openai \
  --model gpt-4

# Switch active provider
aimagicx provider use anthropic

# Remove provider
aimagicx provider remove openai

# List sessions
aimagicx session list
aimagicx session list --all

# Resume session
aimagicx session resume <session-id>

# Rename session
aimagicx session rename <session-id> "Feature Implementation"

# Compact session (reduce context)
aimagicx session compact <session-id>

# Export session
aimagicx session export <session-id> --format markdown
aimagicx session export <session-id> --format json

# Delete session
aimagicx session delete <session-id>

# Show all config
aimagicx config list

# Get specific value
aimagicx config get defaultModel

# Set value
aimagicx config set maxTokens 8192
aimagicx config set autoConfirmWrites true

# Initialize project config
aimagicx config init

# Show config paths
aimagicx config path

# Reset to defaults
aimagicx config reset

# Build vector index
aimagicx index build

# Check index status
aimagicx index status

# Search codebase
aimagicx index search "authentication logic"

# Check API quota/usage
aimagicx usage

# Run diagnostics
aimagicx doctor

# Start server for IDE extensions
aimagicx serve

# Check for updates
aimagicx update

{
  "defaultModel": "claude-sonnet-4-20250514",
  "maxTokens": 16384,
  "maxToolIterations": 10,
  "autoConfirmWrites": false,
  "showTokenUsage": true,
  "contextThreshold": 0.9,
  "autoCompactEnabled": true,
  "useVectorIndex": true,
  "maxContextChunks": 10,
  "maxContextTokens": 8000,
  "minContextScore": 0.15,
  "favoriteModels": ["gpt-4o", "claude-sonnet-4-20250514"],
  "disabledTools": [],
  "approvalMode": "auto"
}

aimagicx provider add ollama \
  --endpoint http://localhost:11434/v1 \
  --protocol openai \
  --model llama3.2

# Change via CLI
aimagicx chat -a read-only
aimagicx chat --yolo  # Alias for -a full

# Or press Tab to cycle modes during chat

# In chat
/spawn Run all tests and fix any failures
/spawn Generate API documentation

# Monitor
/tasks

# Kill a task
/task-kill <id>

# Project: My App

## Architecture
- React frontend with TypeScript
- Express backend with PostgreSQL

## Conventions
- Use functional components with hooks
- All API responses follow { data, error, meta } format

## Do NOT modify
- src/legacy/ (deprecated)

@docs/api-reference.md

# In chat, use # prefix
#project-context This is a React app using TypeScript...

# Or type # to open the memory picker

{
  "commands": [
    {
      "id": "review",
      "name": "Code Review",
      "description": "Review current file",
      "type": "prompt",
      "content": "Review this code for bugs and security issues:\n\n{{input}}"
    },
    {
      "id": "git-log",
      "name": "Git Log",
      "type": "bash",
      "content": "git log --oneline -10",
      "showOutput": true
    }
  ]
}

{
  "agents": [
    {
      "id": "reviewer",
      "name": "Code Reviewer",
      "icon": "🔍",
      "systemPrompt": "You are an expert code reviewer...",
      "model": "claude-sonnet-4-20250514",
      "includeContext": true
    }
  ]
}

{
  "servers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "your-token" }
    }
  }
}

{
  "servers": [
    {
      "name": "typescript",
      "languages": [".ts", ".tsx", ".js", ".jsx"],
      "command": "typescript-language-server",
      "args": ["--stdio"],
      "enabled": true
    }
  ],
  "autoDetect": true,
  "autoStart": true
}

# Large data files
*.csv
data/

# Sensitive files
.env*
secrets/

# Generated files
dist/
build/

aimagicx serve

# Opt out
aimagicx config set telemetryEnabled false

aimagicx doctor

aimagicx auth login --provider <provider-name>

/compact
# Or
aimagicx session compact <session-id>