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.

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

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 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

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 agent skills`	Inspect, install, and remove Skills on an explicitly selected Cloud Agent
`clawdi project`	Create, inspect, share, and manage Projects
`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. 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 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

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.

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 mcp`	Start the MCP stdio server used by configured Agents

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

Sync and inspect Agent data

Work with shared context

Work with secrets and AI Providers

Deploy a Cloud Agent

Work with Channels and MCP

Configure the CLI

​Get started and stay healthy

​Sync and inspect Agent data

​Work with shared context

​Work with secrets and AI Providers

​Deploy a Cloud Agent

​Work with Channels and MCP

​Configure the CLI

Get started and stay healthy

Sync and inspect Agent data

Work with shared context

Work with secrets and AI Providers

Deploy a Cloud Agent

Work with Channels and MCP

Configure the CLI