CLI Reference

Complete command reference for QuantClaw.

Global Options

quantclaw [OPTIONS] COMMAND [ARGS]

• --help, -h — Show help message
• --version, -v — Show version
• --config PATH — Configuration file path
• --log-level LEVEL — Log level: trace, debug, info, warn, error

Commands

agent

Send a message to the agent.

quantclaw agent [OPTIONS] MESSAGE

Options:

• --session SESSION — Session key to use (default: auto-generated)

Examples:

# Send a message (creates a new session automatically)
quantclaw agent "Hello, introduce yourself"

# Use a specific session key
quantclaw agent --session my:project "What's the status?"

run

Send a message to the agent (alias for agent).

quantclaw run MESSAGE

eval

One-shot prompt evaluation — no session history is created or used.

quantclaw eval PROMPT

Examples:

quantclaw eval "What is 2 + 2?"
quantclaw eval "Generate a random UUID"

gateway

Manage the RPC gateway.

quantclaw gateway [SUBCOMMAND] [OPTIONS]

Subcommands:

gateway (no subcommand)

Run the gateway in the foreground.

quantclaw gateway

gateway install

Install the background service definition (systemd --user on Linux, launchd user agent on macOS).

quantclaw gateway install

gateway uninstall

Remove the background service definition.

quantclaw gateway uninstall

gateway start / stop / restart

Control the background service.

quantclaw gateway start
quantclaw gateway stop
quantclaw gateway restart

gateway status

Check whether the gateway background service is running.

quantclaw gateway status

gateway call

Call any RPC method directly.

quantclaw gateway call METHOD [JSON_PARAMS]

Examples:

quantclaw gateway call gateway.health
quantclaw gateway call config.get '{"path":"llm.model"}'

sessions

Manage conversation sessions.

quantclaw sessions SUBCOMMAND [OPTIONS]

sessions list

quantclaw sessions list

sessions history

quantclaw sessions history SESSION_KEY

sessions delete

quantclaw sessions delete SESSION_KEY

sessions reset

quantclaw sessions reset SESSION_KEY

config

Manage configuration.

quantclaw config SUBCOMMAND [OPTIONS]

config get

quantclaw config get                    # Full config
quantclaw config get llm.model         # Specific value (dot-path)

config set

quantclaw config set llm.model "anthropic/claude-sonnet-4-6"

config unset

quantclaw config unset llm.temperature

config reload

Hot-reload config without restarting the gateway.

quantclaw config reload

config validate

quantclaw config validate

config schema

quantclaw config schema

skills

Manage skills.

quantclaw skills SUBCOMMAND

skills list

quantclaw skills list

skills install

Install a skill's dependencies.

quantclaw skills install SKILL_NAME

memory

Search and inspect agent memory.

quantclaw memory SUBCOMMAND [OPTIONS]

memory search

quantclaw memory search "query string"
quantclaw memory search "recent events" --limit 10

Options:

• --limit N — Result limit (default: 5)

memory status

quantclaw memory status

cron

Manage scheduled tasks.

quantclaw cron SUBCOMMAND

cron list

quantclaw cron list

cron add

quantclaw cron add NAME "0 9 * * *" "Send daily summary"

cron remove

quantclaw cron remove TASK_ID

health

Quick health check — confirms the gateway is reachable.

quantclaw health

status

Show connection and session counts.

quantclaw status

logs

View gateway logs. Defaults to the last 50 lines.

quantclaw logs            # Show last 50 lines
quantclaw logs -n 100     # Show last 100 lines
quantclaw logs -f         # Follow logs in real-time
quantclaw logs -n 20 -f   # Follow, starting from last 20 lines

Flag	Description
-n <count>	Number of lines to show (default: 50)
-f	Follow mode — stream new log entries as they arrive

On Linux, falls back to journalctl if no log file is found. On Windows, follow mode (-f) is not supported.

doctor

Run a full diagnostic check.

quantclaw doctor

dashboard

Open the web dashboard in the browser.

quantclaw dashboard

Opens http://127.0.0.1:18801.

onboard

Interactive setup wizard.

quantclaw onboard [OPTIONS]

Options:

• --quick — Quick setup with defaults (non-interactive)
• --install-daemon — Also install the gateway background service definition

Examples:

quantclaw onboard                     # Interactive
quantclaw onboard --quick             # Non-interactive
quantclaw onboard --install-daemon    # Interactive + install background service

In-Conversation Message Commands

While chatting, prefix a message with a slash command to control the session:

Command	Effect
/new	Start a new session
/reset	Clear current session history
/compact	Manually trigger context compaction
/status	Show current session and queue status
/commands	List all available slash commands
/help	Show help text

Environment Variables

Variable	Description
OPENAI_API_KEY	OpenAI / compatible provider API key
ANTHROPIC_API_KEY	Anthropic API key
QUANTCLAW_LOG_LEVEL	Log level override (debug, info, warn, error)
QUANTCLAW_PORT	Sidecar IPC port (internal use, set automatically)

Ports

Service	Port	Purpose
WebSocket RPC Gateway	18800	Main gateway for client connections
HTTP REST API / Dashboard	18801	Web UI and REST API

Complete Workflow Example

# 1. Initial setup
quantclaw onboard --quick

# 2. Install and start the background service
quantclaw gateway install
quantclaw gateway start

# 3. Send a message
quantclaw agent "Hello!"

# 4. View session history
quantclaw sessions list
quantclaw sessions history SESSION_KEY

# 5. Search memory
quantclaw memory search "project notes"

# 6. Check status
quantclaw health
quantclaw status

# 7. Stream logs
quantclaw logs -f

---

Need help? Run quantclaw --help or quantclaw COMMAND --help.