CLI Command Reference

Complete reference for all Crucible CLI commands.

Core Commands

Command	Description
cru chat	Interactive AI chat with session persistence and tool access
cru process	Process markdown files through the pipeline (parse, enrich, store)
cru init	Initialize a new kiln (Crucible workspace)
cru stats	Display kiln statistics
cru status	Display storage status and statistics for the knowledge base
cru models	List available models from configured LLM provider

Agent & Integration Commands

Command	Description
cru agents	Manage agent cards (list, show, validate)
cru mcp	Start MCP server exposing Crucible tools for external AI agents
cru skills	Discover and manage agent skills (list, show, search)
cru tools	Discover and manage tools (list, show)

Session & Configuration Commands

Command	Description
cru session	Manage chat sessions (create, send, pause, resume, end, list, show, search)
cru config	Manage Crucible configuration (initialize, view, export)
cru auth	Manage LLM provider credentials (login, logout, list)
cru set	Configure a running session’s settings (same syntax as TUI :set)

System & Development Commands

Command	Description
cru daemon	Manage the Crucible daemon (start, stop, restart, status)
cru storage	Manage storage operations (migration, verification, backup, cleanup)
cru tasks	Manage tasks from a TASKS.md file (list, next, pick, done)
cru plugin	Manage and develop Lua plugins
cru web	Start the web UI server for browser-based chat
cru doctor	Run installation diagnostics (daemon, config, providers, kiln, embeddings)
cru completions	Generate shell completion scripts (bash, zsh)

Global Options

-l, --log-level <LEVEL>     Set log level (off, error, warn, info, debug, trace)
-v, --verbose               Enable verbose logging (--log-level=debug)
-C, --config <PATH>         Config file path (defaults to ~/.config/crucible/config.toml)
-f, --format <FORMAT>       Output format: table, json, csv (default: table)
    --embedding-url <URL>   Embedding service URL (overrides config)
    --embedding-model <MODEL> Embedding model name (overrides config)
    --standalone            Run with in-process daemon (no background server required)
-h, --help                  Show help
-V, --version               Print version

cru doctor

Run bounded installation diagnostics. Performs exactly five checks:

1. Daemon reachability — connects to the Unix socket to verify the daemon is running
2. Config validity — loads and validates your config file
3. Provider connectivity — pings each configured LLM provider endpoint (2s timeout per provider)
4. Kiln accessibility — checks the kiln path exists, is a directory, and is writable
5. Embedding backend — confirms FastEmbed or Ollama embeddings are available

cru doctor

Exits with code 0 if all checks pass, code 1 if any check fails. Warnings (e.g., read-only kiln, no providers configured) don’t cause a non-zero exit.

Each failed check prints a suggested fix:

✗ Daemon not running
    Try: `cru daemon start`
✗ Config missing at ~/.config/crucible/config.toml
    Try: `cru config init`

See Also

• process - Processing pipeline details
• chat - Chat command reference
• stats - Statistics command
• doctor - Installation diagnostics
• storage - Storage configuration