theo CLI is included in the @hitheo/sdk package.
Install
npm install -g @hitheo/sdk
Commands
| Command | Description |
|---|---|
theo init | Initialize Theo in a project (config + MCP + IDE detection) |
theo login | Authenticate and store API key |
theo logout | Delete stored API key at ~/.theo/credentials |
theo mcp install | Configure MCP for detected/specified IDEs |
theo status | Human-readable connection + health check. Probes both hitheo.ai and www.hitheo.ai to catch the apex-redirect 401 trap. |
theo verify | Machine-readable JSON diagnostic (for CI). Exits 1 when unhealthy or unauthenticated. |
theo complete "<prompt>" | Quick AI completion from terminal |
theo skill init | Scaffold a new skill project |
theo skill validate | Validate a theo-skill.json manifest |
theo skill publish | Submit 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"