ClavueClavue
AI workbench for macOS

CLI reference

imux ships a compatibility CLI still named icc. High-frequency families below; full socket v2 commands follow repo docs and --help. Interactive full-screen sessions: TUI; HTTP model calls: OpenAI-compatible API。

Non-focus socket commands must not steal focus. Only explicit focus commands may activate windows/workspaces. Socket API ≠ api.clavue.com HTTP.

Install CLI

# 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 "you@example.com"

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"}'

See also