CLI commands

Use this page to find a command, then run clawdi <command> --help for the arguments, options, and examples shipped with your CLI version. Object names follow the definitions in Core concepts. The Session sharing/export, Memory update, remote Skill management, and native provider deployment workflows require CLI 0.14.57 or newer. Check clawdi --version and update the CLI when needed. Self-hosted services also need the corresponding API support. Use CLI 0.15.7 or newer for the new Agent, uploaded Session, Wallet, and Cloud resource commands below. Examples follow CLI 0.16, where scripts pass --json explicitly and confirm destructive commands with --yes; see Scripting and automation.

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 agent reconnect`	Restore a lost local connection to an existing Agent
`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

Manage Agents

Command	Purpose
`clawdi agent list`	List your Connected Agents and Cloud Agents, their full IDs, and last activity
`clawdi agent rm <agent-id>`	Disconnect a Connected Agent and archive its workspace, or permanently delete a Cloud Agent and its saved data
`clawdi agent start <agent-id>`	Start a Cloud Agent and wait for completion
`clawdi agent stop <agent-id>`	Stop a Cloud Agent and wait for completion
`clawdi agent restart <agent-id>`	Restart a Cloud Agent and wait for completion
`clawdi agent plugins list <agent-id>`	List requested Cloud Agent plugins and whether they have been applied
`clawdi agent plugins install <agent-id> <plugin-name>`	Request installation of a plugin from the catalog
`clawdi agent plugins rm <agent-id> <plugin-name>`	Request removal of a Cloud Agent plugin

Use the Agent UUID from clawdi agent list. For lifecycle commands, --no-wait returns when the server accepts the operation. Plugin changes return when accepted; check agent plugins list to confirm they were applied.

clawdi agent list --json
clawdi agent rm <connected-agent-id> --yes
clawdi agent rm <cloud-agent-id> --yes --cancel-subscription
clawdi agent start <agent-id> --no-wait
clawdi agent stop <agent-id> --no-wait
clawdi agent restart <agent-id> --no-wait
clawdi agent plugins list <agent-id> --json
clawdi agent plugins install <agent-id> <plugin-name>
clawdi agent plugins rm <agent-id> <plugin-name> --yes

Removing a Cloud Agent permanently deletes its deployment and saved data. A renewing subscription requires a choice: --cancel-subscription cancels it, or --keep-subscription keeps it for a future Agent. Non-interactive removal requires --yes and, for a renewing subscription, one of those options.

Sync and inspect Agent data

Command	Purpose
`clawdi push`	Upload Connected Agent Sessions and Skills available to sync
`clawdi pull`	Mirror Sessions or explicitly import an eligible Project Skill
`clawdi session list`	List local Connected Agent Sessions
`clawdi session list --uploaded`	List Sessions already uploaded to Clawdi
`clawdi session rm <session-id>`	Permanently delete an uploaded Session
`clawdi session search`	Search uploaded message text, summaries, folders, and IDs
`clawdi session read`	Read an uploaded Session using its Cloud Session ID
`clawdi session export`	Export an uploaded Session without publishing a link
`clawdi session share`	Create a public snapshot of a whole conversation or selected portion
`clawdi session shares` / `unshare`	List and revoke active Session links
`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

Use the uploaded Session UUID from session list --uploaded for removal:

clawdi session list --uploaded --limit 10 --json
clawdi session rm <session-id> --yes

Work with shared context

Command family	Purpose
`clawdi memory`	List, search, add, update, and remove Memories
`clawdi skill`	Manage local Connected Agent Skills and Project Skills
`clawdi skill show <key>`	Read a Project Skill without importing it
`clawdi agent skills`	Inspect, install, and remove Skills on an explicitly selected Cloud Agent
`clawdi project`	Create, inspect, share, and manage Projects
`clawdi project rm <project>`	Archive a Project you created
`clawdi inbox`	Review and respond to Project invitations or share links
`clawdi agent projects`	List, link, unlink, or move Projects for an Agent

Use Sessions for share scopes and link IDs, and Skills for the distinction between local software names, Cloud Agent IDs, and Library Skill IDs. Manage account notifications and payment details through the dashboard.

clawdi skill show <skill-key> --project <project-id> --json
clawdi project rm <project-id> --yes

Use link and unlink for Agent Project access. attach and detach remain compatible aliases for existing scripts.

Work with secrets and AI Providers

Command family	Purpose
`clawdi vault`	Manage Vault keys, attachments, imports, and references
`clawdi vault request <key>`	Create a browser link for supplying a secret without the CLI reading its value
`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 Cloud AI Providers, local catalog entries, and credential references
`clawdi ai-provider list`	List Cloud AI Providers and local catalog entries
`clawdi ai-provider edit <provider-id>`	Update a Cloud AI Provider or local catalog entry
`clawdi ai-provider remove <provider-id>`	Remove an AI Provider, confirming any affected Cloud Agents

After sign-in, ai-provider list, edit, and remove work with Cloud AI Providers. The local catalog remains available for import and export; without sign-in, list shows only local entries. Use the provider ID from ai-provider list for edits and removal. vault request --wait waits up to five minutes for the secret to be supplied. The Vault must already be attached to the selected Project.

clawdi ai-provider list --json
clawdi ai-provider edit <provider-id> --label "Main" --json
clawdi ai-provider remove <provider-id> --yes
clawdi vault request <vault-slug>/OPENAI_API_KEY --project <project-id> --wait

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.

Inspect your Wallet

Command	Purpose
`clawdi wallet transactions`	List Wallet transactions
`clawdi wallet usage`	Show usage for the reporting period; select days with `--days`
`clawdi wallet portal`	Print the dashboard billing URL

clawdi wallet transactions --limit 20 --json
clawdi wallet usage --days 7 --json
clawdi wallet portal

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.

Work with Channels and MCP

Command family	Purpose
`clawdi channel`	Manage Channel bots, Agent links, chat pairing, and messages
`clawdi channel unlink <channel-id>`	Unlink an Agent using its Channel link UUID
`clawdi channel unpair <channel-id>`	Unpair one chat using its binding UUID
`clawdi mcp`	Start the MCP stdio server used by configured Agents

clawdi channel unlink <channel-id> --link <link-id> --yes
clawdi channel unpair <channel-id> --binding <binding-id> --yes

Connectors are managed in the Clawdi dashboard, not with a CLI command.

Configure the CLI

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 the complete command list, see clawdi --help and the current CLI reference in the Clawdi repository.

Get started

Use Clawdi

Manage Agents

Account and support

Advanced

Updates

Get started and stay healthy

Manage Agents

Sync and inspect Agent data

Work with shared context

Work with secrets and AI Providers

Inspect your Wallet

Deploy a Cloud Agent

Work with Channels and MCP

Configure the CLI

​Get started and stay healthy

​Manage Agents

​Sync and inspect Agent data

​Work with shared context

​Work with secrets and AI Providers

​Inspect your Wallet

​Deploy a Cloud Agent

​Work with Channels and MCP

​Configure the CLI

Get started and stay healthy

Manage Agents

Sync and inspect Agent data

Work with shared context

Work with secrets and AI Providers

Inspect your Wallet

Deploy a Cloud Agent

Work with Channels and MCP

Configure the CLI