Skip to main content
The theo CLI is included in the @hitheo/sdk package.

​
Install

npm install -g @hitheo/sdk

​
Commands

CommandDescription
theo initInitialize Theo in a project (config + MCP + IDE detection)
theo loginAuthenticate and store API key
theo logoutDelete stored API key at ~/.theo/credentials
theo mcp installConfigure MCP for detected/specified IDEs
theo statusHuman-readable connection + health check. Probes both hitheo.ai and www.hitheo.ai to catch the apex-redirect 401 trap.
theo verifyMachine-readable JSON diagnostic (for CI). Exits 1 when unhealthy or unauthenticated.
theo complete "<prompt>"Quick AI completion from terminal
theo skill initScaffold a new skill project
theo skill validateValidate a theo-skill.json manifest
theo skill publishSubmit skill to marketplace

​
Quick Start

# Set up Theo in your project
theo init

# Confirm connectivity + auth (and detect any redirect 401 trap)
theo status

# Pipe the machine-readable diagnostic into CI
theo verify | jq .authenticated

# Quick completion
theo complete "Write a function to reverse a string"