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

# CLI

> Run CloudThinker agent conversations, query resources, and manage operations directly from your terminal

<Note>
  **Preview** — The CloudThinker CLI is in early access. Command names, flags, and config formats may change before general availability. [Contact us](https://cloudthinker.io/contact) to join the preview.
</Note>

The `cloudthinker` CLI brings agent conversations, resource queries, and operations management to the terminal — useful for shell scripting, CI pipelines, and engineers who prefer keyboards over consoles.

***

## What you can do

| Capability        | Description                                                                         |
| ----------------- | ----------------------------------------------------------------------------------- |
| Chat With Agents  | Open an interactive session with Alex, Oliver, Tony, Kai, or Anna from the terminal |
| One-Shot Prompts  | Run a single `@agent #tool ...` prompt and pipe the result into other tools         |
| Script Operations | Wrap recurring cloud-ops tasks in shell scripts and run them in CI                  |
| Manage Resources  | Inspect connections, resources, recommendations, and incidents                      |

***

## Installation

| Platform    | Method                                             |
| ----------- | -------------------------------------------------- |
| **macOS**   | `brew install cloudthinker/tap/cloudthinker`       |
| **Linux**   | `curl -fsSL https://install.cloudthinker.io \| sh` |
| **Windows** | `winget install CloudThinker.CLI`                  |
| **Docker**  | `docker run cloudthinker/cli`                      |

***

## Authentication

```bash theme={null}
cloudthinker login
```

The CLI uses the same workspace [API keys](/guide/api/overview) as the REST API. Keys are stored in your OS keychain — never written to plaintext config.

***

## Command surface

| Command                              | Purpose                                                     |
| ------------------------------------ | ----------------------------------------------------------- |
| `cloudthinker chat`                  | Open an interactive agent conversation                      |
| `cloudthinker ask "@alex #cost ..."` | One-shot prompt, prints the response                        |
| `cloudthinker resources list`        | Query the unified resource inventory                        |
| `cloudthinker recommendations list`  | List active cost, security, and reliability recommendations |
| `cloudthinker incidents create`      | Open an incident from the terminal                          |
| `cloudthinker skills run <name>`     | Execute a [workspace skill](/guide/skills/overview)         |
| `cloudthinker connections list`      | View configured [connections](/guide/connections/overview)  |

***

## Output formats

| Flag            | Format                                                |
| --------------- | ----------------------------------------------------- |
| `--format text` | Default — human-readable for terminals                |
| `--format json` | Machine-readable for piping into `jq`, scripts, or CI |
| `--format yaml` | Configuration-friendly output                         |

***

## Related

<CardGroup cols={2}>
  <Card title="API" icon="code" href="/guide/api/overview">
    Same operations over HTTPS endpoints
  </Card>

  <Card title="MCP Server" icon="plug" href="/guide/mcp/overview">
    Use CloudThinker from MCP-compatible AI clients
  </Card>

  <Card title="Tasks & Scheduling" icon="calendar-check" href="/guide/automation/tasks">
    Schedule recurring operations
  </Card>

  <Card title="Slack Integration" icon="slack" href="/guide/slack-integration">
    Run the same operations from Slack
  </Card>
</CardGroup>