# CLI
URL: /en-US/docs/cli

TUI, non-interactive -p, SPIRIT_API_KEY / SPIRIT_API_BASE, and the shared daemon.



The CLI is a terminal host. Install it with the [install script](./install/cli.mdx). It talks to the same daemon as [Desktop](./desktop.mdx).

## TUI [#tui]

```bash
cd /path/to/your/project
spirit
```

Layout is `inline` or `fullscreen` (`-t` / `--tui`, or `/tui`). Modes, approvals, and Loop match Desktop.

Useful slash commands: `/help`, `/quit`, `/new`, `/continue`, `/loop`, `/model`, `/session`, `/rewind`, `/fork`, `/subagent`, `/approval`, `/mcp`, `/hook`, `/rule`, `/skill`, `/extension`.

## Non-interactive [#non-interactive]

```bash
spirit -p "your prompt here"
```

Only the final assistant text goes to stdout. Put `-m`, `-a`, and `-l` **before** `-p`. The process fails if a call needs approval or [ask\_questions](./agent/ask-questions.mdx). Headless times out after 30 minutes.

## Environment [#environment]

| Variable          | Role                                                                         |
| ----------------- | ---------------------------------------------------------------------------- |
| `SPIRIT_API_KEY`  | API key for this process. Order: env → model keyring → global keyring        |
| `SPIRIT_API_BASE` | API base URL override                                                        |
| `SPIRIT_DATA_DIR` | Data directory (same store as Desktop)                                       |
| `SPIRIT_HOME`     | CLI binary install root (bin/ and cli/); independent of shared-data settings |

## Shared daemon [#shared-daemon]

`spirit` connects over WebSocket to the Spirit Server daemon. Sessions, streaming, tools, and the approval queue live there. The bearer token is `{spiritDataDir}/server.token` (mode `0600`). The daemon binds `127.0.0.1` on a random port by default.

`spirit serve` runs the daemon in the foreground. Remote `0.0.0.0` is not an open product path. See [Security](./security.mdx).

## Commands [#commands]

```
spirit [-v] [-m model] [-a approval] [-l language] [-t inline|fullscreen] [-p prompt]
spirit interactive
spirit serve
spirit model list|add|remove|use|current
spirit config show|set-base|set-image-model|clear-image-model|set-video-model|clear-video-model|key set|remove|status
spirit mcp …
spirit hook list|validate
spirit permission check --shell <command>|--read-file <path>
spirit extension list|import|remove …
```