CLI reference

Clavue developer runtime is the npm package iclavue (CLI / TUI). imux also ships a compatibility CLI named icc. Install pins for Clavue first, then high-frequency icc families; full socket v2 follows repo docs and --help. Interactive full-screen sessions: TUI; HTTP model calls: OpenAI-compatible API。

Clavue CLI version and install strings sync from site-release pins — not hand-edited marketing copy. Non-focus socket commands must not steal focus. Socket API ≠ api.clavue.com HTTP.

Install Clavue CLI (v11.1.10)

Package name iclavue. Public pins after each release: site-release-latest.json · VERSION · released 2026-08-10

# npm (pinned)
npm install -g [email protected]

# npx
npx -y [email protected]

# install script
curl -fsSL https://www.clavue.com/cli/install.sh | bash -s -- 11.1.10

# Windows signed pager
# https://www.clavue.com/downloads/native/clavue-pager-win32-x64.exe

This release

Unified progress authority: pad Bash never counts; env diagnosis vs code KPI
Reject Run(noop)/true pad tools; fuse stop after 2
Outcome: env next CTA, no Worked-for-1ms overlay, suppress false laziness_fail after tools

Install imux compatibility CLI (icc)

# After imux.app is installed
sudo ln -sf "/Applications/imux.app/Contents/Resources/bin/icc" /usr/local/bin/icc
icc --help

Global

icc --help
icc --version
# Tagged debug instance (isolation)
# ./scripts/reload.sh --tag my-task

Workspace / panes

icc workspace list
icc workspace new --title "agent-run"
icc pane list
icc pane split --direction right

Notifications

icc notify --title "Build" --body "finished"
icc notify --title "Test" --body "failed" --sound

Browser automation

icc browser goto https://example.com
icc browser snapshot
icc browser fill --selector "#email" --text "[email protected]"

Remote

icc ssh user@host
# Uses OpenSSH config; remote explorer after connect

Membership / device code

# Device login (browser approve)
curl -s -X POST https://www.clavue.com/api/membership/auth/device/start \
  -H "content-type: application/json" -d '{"client":"clavue-cli"}'

curl -s -X POST https://www.clavue.com/api/membership/auth/device/poll \
  -H "content-type: application/json" \
  -d '{"device_code":"$DEVICE_CODE"}'

OpenAI-compatible API

export OPENAI_BASE_URL=https://api.clavue.com/v1
export OPENAI_API_KEY=$CLAVUE_TOKEN

curl -s $OPENAI_BASE_URL/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-imux-request-id: mbr_cli_demo_001" \
  -d '{"model":"auto","messages":[{"role":"user","content":"hi"}]}'

Official model ids: auto · clavue · clavue-2.1 · clavue-2.1-fast · clavue-2.1-pro · clavue-2.1-rev · clavue-2.1-search (search / Official MCP only)

Errors include requestId / code / stage / messageZh / debug (no secrets). Headers: x-imux-request-id, x-imux-error-code, x-imux-error-stage. Upstream failures refund the turn quota. Full triage & feedback guide →

Official MCP · web_search

Hosted MCP for web search (not chat). imux tool mcp__clavue__web_search; OpenAI model id clavue-2.1-search. Full usage guide →

# Discover
curl -s https://api.clavue.com/v1/mcp -H "Authorization: Bearer $CLAVUE_TOKEN"

# Call
curl -s https://api.clavue.com/v1/mcp/tools/call \
  -H "Authorization: Bearer $CLAVUE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"web_search","arguments":{"query":"Clavue release notes"}}'

# Equivalent chat.completions
curl -s https://api.clavue.com/v1/chat/completions \
  -H "Authorization: Bearer $CLAVUE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"clavue-2.1-search","stream":false,"messages":[{"role":"user","content":"Clavue release notes"}]}'

Boost packs API

# Status
curl -s https://www.clavue.com/api/membership/boost -H "Cookie: ..."
# Check-in / invite / rush
curl -s -X POST https://www.clavue.com/api/membership/boost \
  -H "content-type: application/json" \
  -d '{"action":"checkin"}'
curl -s -X POST https://www.clavue.com/api/membership/boost \
  -H "content-type: application/json" \
  -d '{"action":"rush_grab"}'