CLI Reference

Every command in the CLOVE CLI. Build agents, manage daemons, connect services, and orchestrate fleets — all from your terminal.

npm install -g @cloveos/cli

Need this as context for an LLM?or fetch/cli-ref/llms.txt

Quick Start

npm install -g @cloveos/cliInstall the CLI globally

clove startStart kernel, API server, and dashboard

clove provider set anthropic sk-ant-xxxAdd your Anthropic API key

clove connect github ghp_xxxConnect GitHub — 26 MCP tools available

clove agent create pr-reviewerCreate a persistent agent

clove daemon start pr-reviewerMake it always-on

Kernel

clove startStart kernel + open dashboard. Detects binary, spawns background process, polls until API ready.

clove stopGraceful shutdown via SIGTERM. Falls back to pkill.

clove statusHealth, version, uptime, syscall count, agent count, run count, memory blocks, total cost.

Agents

clove agent listList all agent definitions with status, triggers, and budget.

clove agent create <name>Create a new agent definition with defaults.

clove agent show <name>Show full agent details — config, triggers, connections, tools, sandbox.

clove agent run <name>Manually trigger an agent run.

clove agent enable <name>Enable agent — starts accepting triggers.

clove agent disable <name>Disable agent — stops all triggers.

clove agent delete <name>Remove agent definition permanently.

Daemon (Always-On)

Daemon agents run a continuous tick loop — checking subscriptions, acting when needed, consolidating memory during idle time. Like hiring a 24/7 employee for $2/day.

clove daemon listShow all running daemons with uptime, tick count, actions, and daily cost.

clove daemon start <name>Start agent as always-on daemon. Tick interval: 60s. Blocking budget: 15s.

clove daemon stop <name>Graceful stop — completes current tick, then shuts down.

clove daemon status <name>Detailed state: status, uptime, ticks, actions, cost, current action.

clove daemon logs <name> [N]Last N daemon log entries. Shows ticks, actions, errors, dream cycles.

clove daemon dream <name>Trigger memory consolidation: Orient → Curate → Consolidate → Prune.

Execution

clove run "goal"Single agent run. Uses CLOVE RunEngine by default.

clove run "goal" --budget 1.0Set max budget for the run.

clove run "goal" --model claude-sonnet-4Specify model.

clove fleet "goal" -n 3Run 3 agents in parallel. Streams SSE events.

clove fleet "goal" --world researchRun fleet in isolated workspace.

Runtimes

CLOVE orchestrates multiple agent runtimes. Claude Code uses Anthropic models only. Codex uses OpenAI models only. CLOVE RunEngine and OpenClaw use any model via OpenRouter.

clove runtime listShow available runtimes and their status.

clove runtime run claude-code "Fix the auth bug"Spawn Claude Code as a subprocess. Requires Anthropic API key.

clove runtime run codex "Write tests for auth.ts"Spawn Codex. Requires OpenAI API key.

Providers

LLM provider API keys. Each runtime uses its provider's key. CLOVE RunEngine uses OpenRouter as the universal gateway.

clove provider listShow configured providers with masked keys.

clove provider set anthropic <key>Add Anthropic API key (for Claude Code agents).

clove provider set openai <key>Add OpenAI API key (for Codex agents).

clove provider set google <key>Add Google AI API key.

clove provider set openrouter <key>Add OpenRouter key (universal fallback).

clove provider remove <name>Remove provider key.

Pipelines

clove pipeline listList all pipeline definitions.

clove pipeline create <name>Create pipeline with a sample step.

clove pipeline show <name>Show pipeline steps, triggers, and budget.

clove pipeline run <name>Execute pipeline with live SSE streaming.

clove pipeline enable <name>Enable pipeline for trigger-based execution.

clove pipeline delete <name>Remove pipeline.

Connections (MCP)

Connect external services via Model Context Protocol. Hot-reload — no kernel restart needed.

clove connect listShow all connected services.

clove connect github <token>Connect GitHub — 26 tools (PRs, issues, repos, commits).

clove connect slack <token>Connect Slack — 12 tools.

clove connect sentry <token>Connect Sentry — alerts, issues.

clove connect linear <token>Connect Linear — project management.

clove connect postgres <url>Connect PostgreSQL database.

clove connect notion <token>Connect Notion.

clove connect filesystemConnect local filesystem.

clove connect remove <name>Disconnect a service.

OpenClaw

clove openclaw statusShow running OpenClaw instances.

clove openclaw spawn <name>Spawn a new OpenClaw chat agent.

clove openclaw spawn bot --soul "helpful assistant"Spawn with personality.

clove openclaw stop <id>Stop an instance.

clove openclaw stop-allStop all instances.

Workspaces

clove world listList all workspaces.

clove world create <name>Create isolated workspace.

clove world launch <template>Launch workspace from template (code-health, code-mapper).

Observability

clove logs [N]Last N audit entries (default 20).

clove recallShow agent memory blocks — name, type, content.

clove store get <key>Read from key-value store.

clove store set <key> <value>Write to key-value store. JSON values supported.

clove policyPolicy recommendations with severity levels.

clove privacy "text with emails"PII scan and redaction.

clove replay statusEvent recording state.

clove replay startBegin recording agent events.

clove replay stopEnd recording.

Configuration

clove configShow current config (JSON).

clove config set <key> <value>Update config. Keys: kernelPath, apiPort, openrouterKey, privacy, sandbox.

clove config get <key>Read a config value.

clove inference showModel gateway config — default model, cost cap, providers.

clove inference set model <id>Set default model.

clove inference set max_cost <N>Set cost cap per request.

clove mcp listShow MCP servers and available tools.

clove mcp add <name> <command>Add MCP server to config.

clove mcp remove <name>Remove MCP server.

Other

clove dashboardOpen dashboard in browser.

clove templatesBrowse agent and pipeline templates.

clove deploy <template>Deploy a template.

clove analyze [path]AI-powered project analysis — recommends agents.

clove schedulerRun the scheduler daemon (cron + webhook dispatch).

clove buildBuild kernel binary from source.

Environment Variables

OPENROUTER_API_KEYDefault OpenRouter key (used by clove start)

CLOVE_KERNEL_PATHPath to kernel binary

ANTHROPIC_API_KEYAnthropic key (passed to Claude Code subprocess)

OPENAI_API_KEYOpenAI key (passed to Codex subprocess)

Architecture

clove CLI ──→ HTTP ──→ CLOVE Kernel (C++)
                            │
                            ├── Runtimes
                            │   ├── CLOVE RunEngine (any model)
                            │   ├── Claude Code (Anthropic only)
                            │   ├── Codex (OpenAI only)
                            │   └── OpenClaw (any model)
                            │
                            ├── Daemon Manager (tick loops)
                            │   ├── Subscriptions (cron, webhook, events)
                            │   └── Dream Engine (memory consolidation)
                            │
                            ├── MCP Bridge ──→ GitHub, Slack, Sentry...
                            ├── State Store (SQLite)
                            ├── Memory Blocks (3-tier)
                            ├── Audit Logger
                            └── Workspace Isolation (kernel sandboxing)