> ## 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.

# Theo Documentation

> AI orchestration API — one call, every model, full pipeline.

<Card title="What is Theo?" icon="info" href="/introduction/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.
</Card>

## Get Started

<CardGroup cols={2}>
  <Card title="Get Your API Key" icon="key" href="/quickstart/get-api-key">
    Sign up and create a key in 30 seconds.
  </Card>

  <Card title="First Completion" icon="terminal" href="/quickstart/first-completion">
    Make your first API call with curl.
  </Card>

  <Card title="Install the SDK" icon="package" href="/quickstart/install-sdk">
    Set up @hitheo/sdk for TypeScript.
  </Card>

  <Card title="Hello World" icon="code" href="/quickstart/hello-world">
    Build a working example in 5 minutes.
  </Card>
</CardGroup>

## Explore

<CardGroup cols={3}>
  <Card title="API Reference" icon="book" href="/api-reference/overview">
    REST API docs for all endpoints.
  </Card>

  <Card title="SDK Reference" icon="box" href="/sdk-reference/installation">
    TypeScript SDK methods and types.
  </Card>

  <Card title="Skills" icon="puzzle" href="/skills/overview">
    Build and publish domain expertise packages.
  </Card>

  <Card title="E.V.I. Guide" icon="bot" href="/guides/build-an-evi">
    Embed Theo in your product with a custom persona.
  </Card>

  <Card title="IDE Integration" icon="laptop" href="/guides/ide-integration">
    Use Theo in Cursor, Claude Code, Warp, and more.
  </Card>

  <Card title="MCP Server" icon="plug" href="/mcp/overview">
    The @hitheo/mcp server, its 8 tools, and 3 resources.
  </Card>

  <Card title="CLI Reference" icon="terminal" href="/cli-reference/overview">
    theo init, status, complete, skill publish.
  </Card>
</CardGroup>

## Set Up in Your IDE

First, set your API key as an environment variable:

```bash theme={null}
export THEO_API_KEY=theo_sk_...
```

Then pick your IDE:

<Tabs>
  <Tab title="Cursor">
    Add to `.cursor/mcp.json` in your project root:

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

    Or run:

    ```bash theme={null}
    theo mcp install --ide cursor
    ```
  </Tab>

  <Tab title="Claude Code">
    Run this in your terminal:

    ```bash theme={null}
    claude mcp add theo npx -y @hitheo/mcp
    ```

    Or run:

    ```bash theme={null}
    theo mcp install --ide claude-code
    ```
  </Tab>

  <Tab title="Warp">
    Add to `.warp/mcp.json` in your project root:

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

    Or run:

    ```bash theme={null}
    theo mcp install --ide warp
    ```
  </Tab>

  <Tab title="Windsurf">
    Add to `~/.codeium/windsurf/mcp_config.json`:

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

    Or run:

    ```bash theme={null}
    theo mcp install --ide windsurf
    ```
  </Tab>

  <Tab title="VS Code">
    Add to `.vscode/mcp.json` in your project root:

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

    Or run:

    ```bash theme={null}
    theo mcp install --ide vscode
    ```
  </Tab>

  <Tab title="All IDEs">
    Auto-detect and configure all installed IDEs at once:

    ```bash theme={null}
    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.
  </Tab>
</Tabs>

Restart your IDE after adding the config.