Skip to main content

​
Variables

VariableRequiredDefaultUsed ByDescription
THEO_API_KEY✅—CLI, SDK, MCPYour theo_sk_... API key
THEO_BASE_URL—https://hitheo.aiCLI, SDK, MCPOverride API base URL

​
Where They’re Used

  • CLI — theo complete, theo status, theo skill publish all read THEO_API_KEY
  • MCP Server — The @hitheo/mcp server reads THEO_API_KEY on startup and injects it into every tool call
  • SDK — The SDK reads THEO_API_KEY when used via CLI; for programmatic use, pass the key directly:
const theo = new Theo({ apiKey: process.env.THEO_API_KEY! });

​
Setting Variables

export THEO_API_KEY=theo_sk_live_a1b2c3d4e5f6...

​
Precedence

  1. Explicit constructor parameter (SDK) or CLI flag
  2. Environment variable
  3. .env file in the current directory
Explicit values always override environment variables.