> ## Documentation Index
> Fetch the complete documentation index at: https://docs.termyte.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI reference

> The public commands shipped by the current Termyte CLI.

# CLI reference

## `termyte init`

Detect supported agents, choose capture integrations and a memory-processing mode, install user-level hooks or plugins, and save the local configuration.

```bash theme={null}
termyte init
```

## `termyte viewer`

Start the local Viewer.

```bash theme={null}
termyte viewer [--no-open] [--host <host>] [--port <port>]
```

The default address is `127.0.0.1:7331`.

## `termyte doctor`

Report database, queue, trace, context-effect, and Claude Code/Codex hook health.

```bash theme={null}
termyte doctor
termyte doctor --json
```

## Work Thread commands

The public command remains `termyte task`. These commands create and manage Work Thread state.

### `termyte task create`

```bash theme={null}
termyte task create --repo <repo-id> --title <title> --objective <objective>
```

### `termyte task show`

```bash theme={null}
termyte task show --task <task-id>
```

Returns the current resume packet as JSON.

### `termyte task add-step`

```bash theme={null}
termyte task add-step --task <task-id> --title <title> --position <n> \
  --version <current-version> [--verification <text>]
```

### `termyte task verify-step`

```bash theme={null}
termyte task verify-step --task <task-id> --step <step-id> \
  --version <current-version> --confirm yes
```

This records explicit user evidence before marking the step verified.

### `termyte task checkpoint`

```bash theme={null}
termyte task checkpoint --task <task-id> --workspace <path> \
  --platform <claude-code|codex|opencode|raw> [--session <session-id>]
```

### `termyte task resume`

```bash theme={null}
termyte task resume --task <task-id> [--workspace <path>]
```

### `termyte task handoff`

```bash theme={null}
termyte task handoff --task <task-id> \
  --source <claude-code|codex|opencode> \
  --target <claude-code|codex|opencode> [--workspace <path>]
```

## `termyte uninstall`

Interactively remove selected Termyte integrations. The database is kept.

```bash theme={null}
termyte uninstall
```

## `termyte help`

```bash theme={null}
termyte help
```

Unknown or retired commands exit with code `2`. Operational errors exit with code `1`.