theo init - Theo API Docs

theo init [directory]

theo init 会通过以下步骤在你的项目中设置 Theo：

创建 theo.config.json —— 项目级配置，包含角色、技能和默认模式
检测已安装的 IDE —— Cursor、Claude Code、Warp、Windsurf、VS Code
写入 MCP 配置 —— 为每个检测到的 IDE 生成正确的 JSON（参见 MCP / Overview）
生成 .theo/RULES.md —— 上下文文件，让 IDE 智能体了解如何使用 Theo

示例

$ 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!

生成的内容

theo.config.json

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

MCP 配置（按 IDE 划分）

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