Documentation Index Fetch the complete documentation index at: https://docs.hitheo.ai/llms.txt
Use this file to discover all available pages before exploring further.
What is Theo? Meet Theo — the AI orchestration engine with a personality. Intent classification, multi-engine routing, skills, and tool execution, all in one API call. Born on Jupiter, built for developers.
Get Started
Get Your API Key Sign up and create a key in 30 seconds.
First Completion Make your first API call with curl.
Install the SDK Set up @hitheo/sdk for TypeScript.
Hello World Build a working example in 5 minutes.
Explore
API Reference REST API docs for all endpoints.
SDK Reference TypeScript SDK methods and types.
Skills Build and publish domain expertise packages.
E.V.I. Guide Embed Theo in your product with a custom persona.
IDE Integration Use Theo in Cursor, Claude Code, Warp, and more.
MCP Server The @hitheo/mcp server, its 8 tools, and 3 resources.
CLI Reference theo init, status, complete, skill publish.
Set Up in Your IDE First, set your API key as an environment variable:
export THEO_API_KEY = theo_sk_ ...
Then pick your IDE:
Cursor
Claude Code
Warp
Windsurf
VS Code
All IDEs
Add to .cursor/mcp.json in your project root: { "mcpServers" : { "theo" : { "command" : "npx" , "args" : [ "-y" , "@hitheo/mcp" ], "env" : { "THEO_API_KEY" : "${env:THEO_API_KEY}" } } } }
Or run: theo mcp install --ide cursor
Run this in your terminal: claude mcp add theo npx -y @hitheo/mcp
Or run: theo mcp install --ide claude-code
Add to .warp/mcp.json in your project root: { "mcpServers" : { "theo" : { "command" : "npx" , "args" : [ "-y" , "@hitheo/mcp" ], "env" : { "THEO_API_KEY" : "${env:THEO_API_KEY}" } } } }
Or run: theo mcp install --ide warp
Add to ~/.codeium/windsurf/mcp_config.json: { "mcpServers" : { "theo" : { "command" : "npx" , "args" : [ "-y" , "@hitheo/mcp" ], "env" : { "THEO_API_KEY" : "${env:THEO_API_KEY}" } } } }
Or run: theo mcp install --ide windsurf
Add to .vscode/mcp.json in your project root: { "mcpServers" : { "theo" : { "command" : "npx" , "args" : [ "-y" , "@hitheo/mcp" ], "env" : { "THEO_API_KEY" : "${env:THEO_API_KEY}" } } } }
Or run: theo mcp install --ide vscode
Auto-detect and configure all installed IDEs at once: npm install -g @hitheo/sdk theo init
This detects Cursor, Claude Code, Warp, Windsurf, and VS Code, writes the correct config for each, and creates a theo.config.json for project-level settings. Restart your IDE after adding the config. 