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

# CLI Overview

> The Theo CLI — project setup, MCP configuration, diagnostics, and skill management.

The `theo` CLI is included in the `@hitheo/sdk` package.

## Install

```bash theme={null}
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

```bash theme={null}
# 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"
```