# CLOVE CLI Reference
# https://cloveos.dev/cli-ref
# Plain text for LLM consumption

## Install
  npm install -g @cloveos/cli

## Quick Start
  clove start                                  Start kernel, API server, and dashboard
  clove provider set anthropic sk-ant-xxx      Add your Anthropic API key
  clove connect github ghp_xxx                 Connect GitHub — 26 MCP tools available
  clove agent create pr-reviewer               Create a persistent agent
  clove daemon start pr-reviewer               Make it always-on

## Kernel
  clove start                                  Start kernel + open dashboard
  clove stop                                   Graceful shutdown
  clove status                                 Health, version, uptime, syscalls, agents, cost

## Agents
  clove agent list                             List all agent definitions
  clove agent create <name>                    Create a new agent definition
  clove agent show <name>                      Show full agent details
  clove agent run <name>                       Manually trigger an agent run
  clove agent enable <name>                    Enable agent
  clove agent disable <name>                   Disable agent
  clove agent delete <name>                    Remove agent definition

## Daemon (Always-On Agents)
Daemon agents run a continuous tick loop — checking subscriptions, acting when needed, consolidating memory during idle time.

  clove daemon list                            Show all running daemons
  clove daemon start <name>                    Start agent as always-on daemon (60s tick, 15s budget)
  clove daemon stop <name>                     Graceful stop
  clove daemon status <name>                   Detailed state
  clove daemon logs <name> [N]                 Last N log entries
  clove daemon dream <name>                    Trigger memory consolidation (Orient → Curate → Consolidate → Prune)

## Execution
  clove run "goal"                             Single agent run
  clove run "goal" --budget 1.0                Set budget cap
  clove run "goal" --model claude-sonnet-4     Specify model
  clove fleet "goal" -n 3                      Run 3 agents in parallel
  clove fleet "goal" --world research          Run in isolated workspace

## Runtimes
Claude Code uses Anthropic models only. Codex uses OpenAI models only. CLOVE RunEngine and OpenClaw use any model via OpenRouter.

  clove runtime list                           Show available runtimes
  clove runtime run claude-code "goal"         Spawn Claude Code subprocess
  clove runtime run codex "goal"               Spawn Codex subprocess

## Providers (LLM API Keys)
  clove provider list                          Show configured providers
  clove provider set anthropic <key>           Add Anthropic key (for Claude Code)
  clove provider set openai <key>              Add OpenAI key (for Codex)
  clove provider set google <key>              Add Google AI key
  clove provider set openrouter <key>          Add OpenRouter key (universal fallback)
  clove provider remove <name>                 Remove provider

## Pipelines
  clove pipeline list                          List all pipelines
  clove pipeline create <name>                 Create pipeline
  clove pipeline show <name>                   Show pipeline steps
  clove pipeline run <name>                    Execute with SSE streaming
  clove pipeline enable <name>                 Enable pipeline
  clove pipeline delete <name>                 Remove pipeline

## Connections (MCP)
Hot-reload — no kernel restart needed.

  clove connect list                           Show all connections
  clove connect github <token>                 Connect GitHub (26 tools)
  clove connect slack <token>                  Connect Slack (12 tools)
  clove connect sentry <token>                 Connect Sentry
  clove connect linear <token>                 Connect Linear
  clove connect postgres <url>                 Connect PostgreSQL
  clove connect notion <token>                 Connect Notion
  clove connect filesystem                     Connect local filesystem
  clove connect remove <name>                  Disconnect service

## OpenClaw
  clove openclaw status                        Show running instances
  clove openclaw spawn <name>                  Spawn new instance
  clove openclaw spawn <name> --soul "desc"    Spawn with personality
  clove openclaw stop <id>                     Stop instance
  clove openclaw stop-all                      Stop all instances

## Workspaces
  clove world list                             List all workspaces
  clove world create <name>                    Create isolated workspace
  clove world launch <template>                Launch from template

## Observability
  clove logs [N]                               Last N audit entries (default 20)
  clove recall                                 Show agent memory blocks
  clove store get <key>                        Read from key-value store
  clove store set <key> <value>                Write to store (JSON supported)
  clove policy                                 Policy recommendations
  clove privacy "text"                         PII scan and redaction
  clove replay status                          Event recording state
  clove replay start                           Begin recording
  clove replay stop                            End recording

## Configuration
  clove config                                 Show current config
  clove config set <key> <value>               Update config
  clove config get <key>                       Read config value
  clove inference show                         Model gateway config
  clove inference set model <id>               Set default model
  clove inference set max_cost <N>             Set cost cap
  clove mcp list                               Show MCP servers and tools
  clove mcp add <name> <command>               Add MCP server
  clove mcp remove <name>                      Remove MCP server

## Other
  clove dashboard                              Open dashboard in browser
  clove templates                              Browse templates
  clove deploy <template>                      Deploy a template
  clove analyze [path]                         AI project analysis
  clove scheduler                              Run scheduler daemon
  clove build                                  Build kernel from source

## Environment Variables
  OPENROUTER_API_KEY                           Default OpenRouter key
  CLOVE_KERNEL_PATH                            Path to kernel binary
  ANTHROPIC_API_KEY                            Anthropic key (for Claude Code)
  OPENAI_API_KEY                               OpenAI key (for Codex)

## Architecture
  clove CLI ──→ HTTP ──→ CLOVE Kernel (C++) ──→ Runtimes (CLOVE/Claude Code/Codex/OpenClaw)
                             ├── Daemon Manager (tick loops + dream engine)
                             ├── MCP Bridge ──→ GitHub, Slack, Sentry...
                             ├── State Store (SQLite)
                             ├── Memory Blocks (3-tier)
                             ├── Audit Logger
                             └── Workspace Isolation (kernel sandboxing)

## Runtime-Model Constraints
  CLOVE RunEngine  → Any model (via OpenRouter)
  Claude Code      → Anthropic only (Claude Opus 4, Sonnet 4, Haiku 4)
  Codex            → OpenAI only (GPT-4o, GPT-4o Mini, o3-mini, Codex)
  OpenClaw         → Any model (via OpenRouter)