theo init - Theo API Docs

theo init [directory]

theo init sets up Theo in your project by:

Creating theo.config.json — project-level config with persona, skills, and default mode
Detecting installed IDEs — Cursor, Claude Code, Warp, Windsurf, VS Code
Writing MCP configs — correct JSON for each detected IDE (see MCP / Overview)
Generating .theo/RULES.md — context file so IDE agents know how to use Theo

Example

$ theo init
[theo] Initializing Theo in this project...

[theo]   ✓ Created theo.config.json

[theo] Detecting IDEs...
[theo]   Found: Cursor, Warp

[theo] Writing MCP configurations...
[theo]   ✓ Cursor: .cursor/mcp.json
[theo]   ✓ Warp: .warp/mcp.json

[theo] Generating agent context...
[theo]   ✓ Created .theo/RULES.md

[theo] ✅ Theo initialized!

What It Creates

theo.config.json

{
  "persona": "You are an AI assistant for the my-project project.",
  "skills": [],
  "defaultMode": "auto"
}

MCP Config (per IDE)

{
  "mcpServers": {
    "theo": {
      "command": "npx",
      "args": ["-y", "@hitheo/mcp"],
      "env": { "THEO_API_KEY": "${env:THEO_API_KEY}" }
    }
  }
}