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

> ## Agent Instructions
> Treat Clawdi as one product.
> Recommend the Cloud Agent quickstart for most new users.
> Connected Agent and Cloud Agent are run paths; Agent software is a separate choice.
> Do not present shared Clawdi capabilities as exclusive to one run path.

# CLI command map

> Find the current Clawdi command family for a common user task.

This page is intentionally compact. Run `clawdi <command> --help` for the
arguments, options, and examples shipped with your CLI version. Object names
follow the definitions in [Core concepts](/concepts/core-concepts).

## Get started and stay healthy

| Command                        | Purpose                                                                                                      |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------ |
| `clawdi auth login` / `logout` | Add or remove this computer's authentication                                                                 |
| `clawdi auth status`           | Show the credential source without printing secrets                                                          |
| `clawdi setup`                 | Detect Agent software, register Connected Agents, add MCP, install the bundled Skill, and install the daemon |
| `clawdi teardown`              | Reverse Connected Agent setup                                                                                |
| `clawdi status`                | Show authentication and sync activity                                                                        |
| `clawdi doctor`                | Diagnose authentication, reachability, Agent paths, Vault metadata, and MCP                                  |
| `clawdi update`                | Install the latest CLI version; use `--check` to report only                                                 |

## Sync and inspect Agent data

| Command                  | Purpose                                                        |
| ------------------------ | -------------------------------------------------------------- |
| `clawdi push`            | Upload supported Connected Agent Sessions and Skills           |
| `clawdi pull`            | Mirror Sessions or explicitly import an eligible Project Skill |
| `clawdi session list`    | List local Connected Agent Sessions                            |
| `clawdi session extract` | Extract Memories from a local Session through Clawdi           |
| `clawdi daemon status`   | Inspect the background sync daemon                             |
| `clawdi daemon logs`     | Read daemon logs                                               |
| `clawdi daemon restart`  | Restart the daemon after refreshing setup                      |

## Work with shared context

| Command family          | Purpose                                                  |
| ----------------------- | -------------------------------------------------------- |
| `clawdi memory`         | List, search, add, and remove Memories                   |
| `clawdi skill`          | List, add, install, initialize, and remove Skills        |
| `clawdi project`        | Create, inspect, share, and manage Projects              |
| `clawdi inbox`          | Review and respond to Project invitations or share links |
| `clawdi agent projects` | List, attach, detach, or move Projects for an Agent      |

## Work with secrets and AI Providers

| Command family               | Purpose                                                     |
| ---------------------------- | ----------------------------------------------------------- |
| `clawdi vault`               | Manage Vault keys, attachments, imports, and references     |
| `clawdi read <clawdi://...>` | Explicitly print one resolved Vault value                   |
| `clawdi inject`              | Render `clawdi://` references into an output file           |
| `clawdi run`                 | Run a child command with explicit Vault references resolved |
| `clawdi ai-provider`         | Manage local AI Provider records and credential references  |

<Warning>
  `clawdi read` and non-dry-run secret commands can expose plaintext to the
  terminal or a child process. Prefer `--dry-run` first and avoid placing
  secret values directly in command-line flags.
</Warning>

## Deploy a Cloud Agent

| Command family  | Purpose                                                                |
| --------------- | ---------------------------------------------------------------------- |
| `clawdi deploy` | Create a remotely running Agent with the interactive deployment wizard |

This workflow is available only for Cloud Agents. Run `clawdi deploy --help`
for current choices and automation requirements. See [Automate Cloud Agent
deployment](/cloud-agents/deployment-automation).

## Work with Channels and MCP

| Command family   | Purpose                                                      |
| ---------------- | ------------------------------------------------------------ |
| `clawdi channel` | Manage Channel bots, Agent links, chat pairing, and messages |
| `clawdi mcp`     | Start the MCP stdio server used by configured Agents         |

Connectors are managed in the [Clawdi
dashboard](https://cloud.clawdi.ai), not with a CLI command.

## Configure the CLI

```bash theme={null}
clawdi config list
clawdi config get <key>
clawdi config set <key> <value>
clawdi config unset <key>
clawdi config paths
```

Use `clawdi config paths` to identify the local paths used by the current CLI
installation. Do not edit generated or credential files unless a specific
troubleshooting guide tells you to.

For an exhaustive command list, see `clawdi --help` and the [current CLI
reference in the Clawdi
repository](https://github.com/Clawdi-AI/clawdi#cli-reference).