跳到主要内容

CLI 参考

本页面描述了当前的 CLI 行为。如果命令发生变化，请更新此文档。

命令页面​

全局标志位​

  • --dev: 将状态隔离在 ~/.clawdbot-dev 下，并偏移默认端口。
  • --profile <name>: 将状态隔离在 ~/.clawdbot-<name> 下。
  • --no-color: 禁用 ANSI 颜色。
  • --update: clawdbot update 的简写（仅限源码安装）。
  • -V, --version, -v: 打印版本并退出。

输出样式​

  • ANSI 颜色和进度指示器仅在 TTY 会话中渲染。
  • OSC-8 超链接在支持的终端中渲染为可点击链接；否则我们将回退到纯文本 URL。
  • --json（以及支持的 --plain）禁用样式以获得干净的输出。
  • --no-color 禁用 ANSI 样式；同时也支持 NO_COLOR=1。
  • 长时间运行的命令会显示进度指示器（支持时为 OSC 9;4）。

调色板​

Clawdbot 在 CLI 输出中使用龙虾调色板（lobster palette）。

  • accent (#FF5A2D): 标题、标签、主要高亮。
  • accentBright (#FF7A3D): 命令名称、强调。
  • accentDim (#D14A22): 次要高亮文本。
  • info (#FF8A5B): 信息值。
  • success (#2FBF71): 成功状态。
  • warn (#FFB020): 警告、回退、注意。
  • error (#E23D2D): 错误、失败。
  • muted (#8B7F77): 去强调、元数据。

调色板权威来源：src/terminal/palette.ts（又名 “lobster seam”）。

命令树​

clawdbot [--dev] [--profile <name>] <command>
  setup
  onboard
  configure
  config
    get
    set
    unset
  doctor
  security
    audit
  reset
  uninstall
  update
  channels
    list
    status
    logs
    add
    remove
    login
    logout
  skills
    list
    info
    check
  plugins
    list
    info
    install
    enable
    disable
    doctor
  memory
    status
    index
    search
  message
  agent
  agents
    list
    add
    delete
  acp
  status
  health
  sessions
  gateway
    call
    health
    status
    probe
    discover
    install
    uninstall
    start
    stop
    restart
    run
  logs
  system
    event
    heartbeat last|enable|disable
    presence
  models
    list
    status
    set
    set-image
    aliases list|add|remove
    fallbacks list|add|remove|clear
    image-fallbacks list|add|remove|clear
    scan
    auth add|setup-token|paste-token
    auth order get|set|clear
  sandbox
    list
    recreate
    explain
  cron
    status
    list
    add
    edit
    rm
    enable
    disable
    runs
    run
  nodes
  devices
  node
    run
    status
    install
    uninstall
    start
    stop
    restart
  approvals
    get
    set
    allowlist add|remove
  browser
    status
    start
    stop
    reset-profile
    tabs
    open
    focus
    close
    profiles
    create-profile
    delete-profile
    screenshot
    snapshot
    navigate
    resize
    click
    type
    press
    hover
    drag
    select
    upload
    fill
    dialog
    wait
    evaluate
    console
    pdf
  hooks
    list
    info
    check
    enable
    disable
    install
    update
  webhooks
    gmail setup|run
  pairing
    list
    approve
  docs
  dns
    setup
  tui

注意：插件可以添加额外的顶层命令（例如 clawdbot voicecall）。

安全​

  • clawdbot security audit — 审计配置 + 本地状态以查找常见的安全隐患。
  • clawdbot security audit --deep — 尽力而为的实时网关探测。
  • clawdbot security audit --fix — 收紧安全默认值并修改状态/配置的权限 (chmod)。

插件​

管理扩展及其配置：

  • clawdbot plugins list — 发现插件（机器输出请使用 --json）。
  • clawdbot plugins info <id> — 显示插件的详细信息。
  • clawdbot plugins install <path|.tgz|npm-spec> — 安装插件（或将插件路径添加到 plugins.load.paths）。
  • clawdbot plugins enable <id> / disable <id> — 切换 plugins.entries.<id>.enabled。
  • clawdbot plugins doctor — 报告插件加载错误。

大多数插件更改需要重启网关。请参阅 /plugin。

记忆 (Memory)​

对 MEMORY.md + memory/*.md 进行向量搜索：

  • clawdbot memory status — 显示索引统计信息。
  • clawdbot memory index — 重新索引记忆文件。
  • clawdbot memory search "<query>" — 对记忆进行语义搜索。

聊天斜杠命令​

聊天消息支持 /... 命令（文本和原生）。请参阅 /tools/slash-commands。

亮点：

  • /status 用于快速诊断。
  • /config 用于持久化的配置更改。
  • /debug 用于仅运行时的配置覆盖（存储在内存中，而非磁盘；需要 commands.debug: true）。

设置 + 入门​

setup​

初始化配置 + 工作区。

选项：

  • --workspace <dir>: 代理工作区路径（默认 ~/clawd）。
  • --wizard: 运行入门向导。
  • --non-interactive: 无需提示运行向导。
  • --mode <local|remote>: 向导模式。
  • --remote-url <url>: 远程网关 URL。
  • --remote-token <token>: 远程网关令牌。

当存在任何向导标志位（--non-interactive, --mode, --remote-url, --remote-token）时，向导会自动运行。

onboard​

交互式向导，用于设置网关、工作区和技能。

选项：

  • --workspace <dir>
  • --reset (在运行向导前重置配置 + 凭据 + 会话 + 工作区)
  • --non-interactive
  • --mode <local|remote>
  • --flow <quickstart|advanced|manual> (manual 是 advanced 的别名)
  • --auth-choice <setup-token|claude-cli|token|openai-codex|openai-api-key|openrouter-api-key|ai-gateway-api-key|moonshot-api-key|kimi-code-api-key|codex-cli|gemini-api-key|zai-api-key|apiKey|minimax-api|opencode-zen|skip>
  • --token-provider <id> (非交互式；与 --auth-choice token 配合使用)
  • --token <token> (非交互式；与 --auth-choice token 配合使用)
  • --token-profile-id <id> (非交互式；默认: <provider>:manual)
  • --token-expires-in <duration> (非交互式；例如 365d, 12h)
  • --anthropic-api-key <key>
  • --openai-api-key <key>
  • --openrouter-api-key <key>
  • --ai-gateway-api-key <key>
  • --moonshot-api-key <key>
  • --kimi-code-api-key <key>
  • --gemini-api-key <key>
  • --zai-api-key <key>
  • --minimax-api-key <key>
  • --opencode-zen-api-key <key>
  • --gateway-port <port>
  • --gateway-bind <loopback|lan|tailnet|auto|custom>
  • --gateway-auth <off|token|password>
  • --gateway-token <token>
  • --gateway-password <password>
  • --remote-url <url>
  • --remote-token <token>
  • --tailscale <off|serve|funnel>
  • --tailscale-reset-on-exit
  • --install-daemon
  • --no-install-daemon (别名: --skip-daemon)
  • --daemon-runtime <node|bun>
  • --skip-channels
  • --skip-skills
  • --skip-health
  • --skip-ui
  • --node-manager <npm|pnpm|bun> (推荐使用 pnpm；不推荐将 bun 用于网关运行时)
  • --json

configure​

交互式配置向导（模型、渠道、技能、网关）。

config​

非交互式配置助手（get/set/unset）。运行不带子命令的 clawdbot config 会启动向导。

子命令：

  • config get <path>: 打印配置值（点号/方括号路径）。
  • config set <path> <value>: 设置值（JSON5 或原始字符串）。
  • config unset <path>: 移除值。

doctor​

健康检查 + 快速修复（配置 + 网关 + 遗留服务）。

选项：

  • --no-workspace-suggestions: 禁用工作区记忆提示。
  • --yes: 无需提示接受默认值（无头模式）。
  • --non-interactive: 跳过提示；仅应用安全的迁移。
  • --deep: 扫描系统服务以查找额外的网关安装。

渠道助手​

channels​

管理聊天渠道账户（WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (插件)/Signal/iMessage/MS Teams）。

子命令：

  • channels list: 显示配置的渠道和认证配置文件（包含 Claude Code + Codex CLI OAuth 同步）。
  • channels status: 检查网关可达性和渠道健康状况（--probe 运行额外检查；使用 clawdbot health 或 clawdbot status --deep 进行网关健康探测）。
  • 提示：channels status 在检测到常见配置错误时会打印带有建议修复方法的警告（然后引导你使用 clawdbot doctor）。
  • channels logs: 从网关日志文件中显示最近的渠道日志。
  • channels add: 未传递标志位时为向导式设置；标志位会切换到非交互模式。
  • channels remove: 默认禁用；传递 --delete 以无需提示移除配置条目。
  • channels login: 交互式渠道登录（仅限 WhatsApp Web）。
  • channels logout: 退出渠道会话（如果支持）。

常用选项：

  • --channel <name>: whatsapp|telegram|discord|googlechat|slack|mattermost|signal|imessage|msteams
  • --account <id>: 渠道账户 ID（默认 default）
  • --name <label>: 账户的显示名称

channels login 选项：

  • --channel <channel> (默认 whatsapp; 支持 whatsapp/web)
  • --account <id>
  • --verbose

channels logout 选项：

  • --channel <channel> (默认 whatsapp)
  • --account <id>

channels list 选项：

  • --no-usage: 跳过模型提供商的用量/配额快照（仅限 OAuth/API 驱动）。
  • --json: 输出 JSON（除非设置了 --no-usage，否则包含用量）。

channels logs 选项：

  • --channel <name|all> (默认 all)
  • --lines <n> (默认 200)
  • --json

OAuth 同步来源：

  • Claude Code → anthropic:claude-cli
    • macOS: 钥匙串项目 "Claude Code-credentials"（选择 "始终允许" 以避免 launchd 提示）
    • Linux/Windows: ~/.claude/.credentials.json
  • ~/.codex/auth.json → openai-codex:codex-cli

更多详情：/concepts/oauth

示例：

clawdbot channels add --channel telegram --account alerts --name "Alerts Bot" --token $TELEGRAM_BOT_TOKEN
clawdbot channels add --channel discord --account work --name "Work Bot" --token $DISCORD_BOT_TOKEN
clawdbot channels remove --channel discord --account work --delete
clawdbot channels status --probe
clawdbot status --deep

skills​

列出并检查可用技能以及就绪信息。

子命令：

  • skills list: 列出技能（无子命令时的默认行为）。
  • skills info <name>: 显示单个技能的详细信息。
  • skills check: 就绪与缺失要求的摘要。

选项：

  • --eligible: 仅显示就绪的技能。
  • --json: 输出 JSON（无样式）。
  • -v, --verbose: 包含缺失要求的详细信息。

提示：使用 npx clawdhub 来搜索、安装和同步技能。

pairing​

批准跨渠道的私聊配对请求。

子命令：

  • pairing list <channel> [--json]
  • pairing approve <channel> <code> [--notify]

webhooks gmail​

Gmail Pub/Sub 钩子设置 + 运行器。请参阅 /automation/gmail-pubsub。

子命令：

  • webhooks gmail setup (需要 --account <email>; 支持 --project, --topic, --subscription, --label, --hook-url, --hook-token, --push-token, --bind, --port, --path, --include-body, --max-bytes, --renew-minutes, --tailscale, --tailscale-path, --tailscale-target, --push-endpoint, --json)
  • webhooks gmail run (同一标志位的运行时覆盖)

dns setup​

广域发现 DNS 助手 (CoreDNS + Tailscale)。请参阅 /gateway/discovery。

选项：

  • --apply: 安装/更新 CoreDNS 配置（需要 sudo；仅限 macOS）。

消息传递 + 代理​

message​

统一的出站消息传递 + 渠道操作。

请参阅：/cli/message

子命令：

  • message send|poll|react|reactions|read|edit|delete|pin|unpin|pins|permissions|search|timeout|kick|ban
  • message thread <create|list|reply>
  • message emoji <list|upload>
  • message sticker <send|upload>
  • message role <info|add|remove>
  • message channel <info|list>
  • message member info
  • message voice status
  • message event <list|create>

示例：

  • clawdbot message send --target +15555550123 --message "Hi"
  • clawdbot message poll --channel discord --target channel:123 --poll-question "Snack?" --poll-option Pizza --poll-option Sushi

agent​

通过网关（或 --local 嵌入式）运行单轮代理。

必需：

  • --message <text>

选项：

  • --to <dest> (用于会话密钥和可选的投递)
  • --session-id <id>
  • --thinking <off|minimal|low|medium|high|xhigh> (仅限 GPT-5.2 + Codex 模型)
  • --verbose <on|full|off>
  • --channel <whatsapp|telegram|discord|slack|mattermost|signal|imessage|msteams>
  • --local
  • --deliver
  • --json
  • --timeout <seconds>

agents​

管理隔离的代理（工作区 + 认证 + 路由）。

agents list​

列出已配置的代理。

选项：

  • --json
  • --bindings

agents add [name]​

添加一个新的隔离代理。除非传递了标志位（或 --non-interactive），否则将运行引导式向导；在非交互模式下，--workspace 是必需的。

选项：

  • --workspace <dir>
  • --model <id>
  • --agent-dir <dir>
  • --bind <channel[:accountId]> (repeatable)
  • --non-interactive
  • --json

Binding specs use channel[:accountId]. When accountId is omitted for WhatsApp, the default account id is used.

agents delete <id>​

Delete an agent and prune its workspace + state.

Options:

  • --force
  • --json

acp​

Run the ACP bridge that connects IDEs to the Gateway.

See acp for full options and examples.

status​

Show linked session health and recent recipients.

Options:

  • --json
  • --all (full diagnosis; read-only, pasteable)
  • --deep (probe channels)
  • --usage (show model provider usage/quota)
  • --timeout <ms>
  • --verbose
  • --debug (alias for --verbose)

Notes:

  • Overview includes Gateway + node host service status when available.

Usage tracking​

Clawdbot can surface provider usage/quota when OAuth/API creds are available.

Surfaces:

  • /status (adds a short provider usage line when available)
  • clawdbot status --usage (prints full provider breakdown)
  • macOS menu bar (Usage section under Context)

Notes:

  • Data comes directly from provider usage endpoints (no estimates).
  • Providers: Anthropic, GitHub Copilot, OpenAI Codex OAuth, plus Gemini CLI/Antigravity when those provider plugins are enabled.
  • If no matching credentials exist, usage is hidden.
  • Details: see Usage tracking.

health​

Fetch health from the running Gateway.

Options:

  • --json
  • --timeout <ms>
  • --verbose

sessions​

List stored conversation sessions.

Options:

  • --json
  • --verbose
  • --store <path>
  • --active <minutes>

Reset / Uninstall​

reset​

Reset local config/state (keeps the CLI installed).

Options:

  • --scope <config|config+creds+sessions|full>
  • --yes
  • --non-interactive
  • --dry-run

Notes:

  • --non-interactive requires --scope and --yes.

uninstall​

Uninstall the gateway service + local data (CLI remains).

Options:

  • --service
  • --state
  • --workspace
  • --app
  • --all
  • --yes
  • --non-interactive
  • --dry-run

Notes:

  • --non-interactive requires --yes and explicit scopes (or --all).

Gateway​

gateway​

Run the WebSocket Gateway.

Options:

  • --port <port>
  • --bind <loopback|tailnet|lan|auto|custom>
  • --token <token>
  • --auth <token|password>
  • --password <password>
  • --tailscale <off|serve|funnel>
  • --tailscale-reset-on-exit
  • --allow-unconfigured
  • --dev
  • --reset (reset dev config + credentials + sessions + workspace)
  • --force (kill existing listener on port)
  • --verbose
  • --claude-cli-logs
  • --ws-log <auto|full|compact>
  • --compact (alias for --ws-log compact)
  • --raw-stream
  • --raw-stream-path <path>

gateway service​

Manage the Gateway service (launchd/systemd/schtasks).

Subcommands:

  • gateway status (probes the Gateway RPC by default)
  • gateway install (service install)
  • gateway uninstall
  • gateway start
  • gateway stop
  • gateway restart

Notes:

  • gateway status probes the Gateway RPC by default using the service’s resolved port/config (override with --url/--token/--password).
  • gateway status supports --no-probe, --deep, and --json for scripting.
  • gateway status also surfaces legacy or extra gateway services when it can detect them (--deep adds system-level scans). Profile-named Clawdbot services are treated as first-class and aren't flagged as "extra".
  • gateway status prints which config path the CLI uses vs which config the service likely uses (service env), plus the resolved probe target URL.
  • gateway install|uninstall|start|stop|restart support --json for scripting (default output stays human-friendly).
  • gateway install defaults to Node runtime; bun is not recommended (WhatsApp/Telegram bugs).
  • gateway install options: --port, --runtime, --token, --force, --json.

logs​

Tail Gateway file logs via RPC.

Notes:

  • TTY sessions render a colorized, structured view; non-TTY falls back to plain text.
  • --json emits line-delimited JSON (one log event per line).

Examples:

clawdbot logs --follow
clawdbot logs --limit 200
clawdbot logs --plain
clawdbot logs --json
clawdbot logs --no-color

gateway <subcommand>​

Gateway CLI helpers (use --url, --token, --password, --timeout, --expect-final for RPC subcommands).

Subcommands:

  • gateway call <method> [--params <json>]
  • gateway health
  • gateway status
  • gateway probe
  • gateway discover
  • gateway install|uninstall|start|stop|restart
  • gateway run

Common RPCs:

  • config.apply (validate + write config + restart + wake)
  • config.patch (merge a partial update + restart + wake)
  • update.run (run update + restart + wake)

Tip: when calling config.set/config.apply/config.patch directly, pass baseHash from config.get if a config already exists.

Models​

See /concepts/models for fallback behavior and scanning strategy.

Preferred Anthropic auth (CLI token, not API key):

claude setup-token
clawdbot models status

models (root)​

clawdbot models is an alias for models status.

Root options:

  • --status-json (alias for models status --json)
  • --status-plain (alias for models status --plain)

models list​

Options:

  • --all
  • --local
  • --provider <name>
  • --json
  • --plain

models status​

Options:

  • --json
  • --plain
  • --check (exit 1=expired/missing, 2=expiring)
  • --probe (live probe of configured auth profiles)
  • --probe-provider <name>
  • --probe-profile <id> (repeat or comma-separated)
  • --probe-timeout <ms>
  • --probe-concurrency <n>
  • --probe-max-tokens <n>

Always includes the auth overview and OAuth expiry status for profiles in the auth store. --probe runs live requests (may consume tokens and trigger rate limits).

models set <model>​

Set agents.defaults.model.primary.

models set-image <model>​

Set agents.defaults.imageModel.primary.

models aliases list|add|remove​

Options:

  • list: --json, --plain
  • add <alias> <model>
  • remove <alias>

models fallbacks list|add|remove|clear​

Options:

  • list: --json, --plain
  • add <model>
  • remove <model>
  • clear

models image-fallbacks list|add|remove|clear​

Options:

  • list: --json, --plain
  • add <model>
  • remove <model>
  • clear

models scan​

Options:

  • --min-params <b>
  • --max-age-days <days>
  • --provider <name>
  • --max-candidates <n>
  • --timeout <ms>
  • --concurrency <n>
  • --no-probe
  • --yes
  • --no-input
  • --set-default
  • --set-image
  • --json

models auth add|setup-token|paste-token​

Options:

  • add: interactive auth helper
  • setup-token: --provider <name> (default anthropic), --yes
  • paste-token: --provider <name>, --profile-id <id>, --expires-in <duration>

models auth order get|set|clear​

Options:

  • get: --provider <name>, --agent <id>, --json
  • set: --provider <name>, --agent <id>, <profileIds...>
  • clear: --provider <name>, --agent <id>

System​

system event​

Enqueue a system event and optionally trigger a heartbeat (Gateway RPC).

Required:

  • --text <text>

Options:

  • --mode <now|next-heartbeat>
  • --json
  • --url, --token, --timeout, --expect-final

system heartbeat last|enable|disable​

Heartbeat controls (Gateway RPC).

Options:

  • --json
  • --url, --token, --timeout, --expect-final

system presence​

List system presence entries (Gateway RPC).

Options:

  • --json
  • --url, --token, --timeout, --expect-final

Cron​

Manage scheduled jobs (Gateway RPC). See /automation/cron-jobs.

Subcommands:

  • cron status [--json]
  • cron list [--all] [--json] (table output by default; use --json for raw)
  • cron add (alias: create; requires --name and exactly one of --at | --every | --cron, and exactly one payload of --system-event | --message)
  • cron edit <id> (patch fields)
  • cron rm <id> (aliases: remove, delete)
  • cron enable <id>
  • cron disable <id>
  • cron runs --id <id> [--limit <n>]
  • cron run <id> [--force]

All cron commands accept --url, --token, --timeout, --expect-final.

Node host​

node runs a headless node host or manages it as a background service. See clawdbot node.

Subcommands:

  • node run --host <gateway-host> --port 18789
  • node status
  • node install [--host <gateway-host>] [--port <port>] [--tls] [--tls-fingerprint <sha256>] [--node-id <id>] [--display-name <name>] [--runtime <node|bun>] [--force]
  • node uninstall
  • node stop
  • node restart

Nodes​

nodes talks to the Gateway and targets paired nodes. See /nodes.

Common options:

  • --url, --token, --timeout, --json

Subcommands:

  • nodes status [--connected] [--last-connected <duration>]
  • nodes describe --node <id|name|ip>
  • nodes list [--connected] [--last-connected <duration>]
  • nodes pending
  • nodes approve <requestId>
  • nodes reject <requestId>
  • nodes rename --node <id|name|ip> --name <displayName>
  • nodes invoke --node <id|name|ip> --command <command> [--params <json>] [--invoke-timeout <ms>] [--idempotency-key <key>]
  • nodes run --node <id|name|ip> [--cwd <path>] [--env KEY=VAL] [--command-timeout <ms>] [--needs-screen-recording] [--invoke-timeout <ms>] <command...> (mac node or headless node host)
  • nodes notify --node <id|name|ip> [--title <text>] [--body <text>] [--sound <name>] [--priority <passive|active|timeSensitive>] [--delivery <system|overlay|auto>] [--invoke-timeout <ms>] (mac only)

Camera:

  • nodes camera list --node <id|name|ip>
  • nodes camera snap --node <id|name|ip> [--facing front|back|both] [--device-id <id>] [--max-width <px>] [--quality <0-1>] [--delay-ms <ms>] [--invoke-timeout <ms>]
  • nodes camera clip --node <id|name|ip> [--facing front|back] [--device-id <id>] [--duration <ms|10s|1m>] [--no-audio] [--invoke-timeout <ms>]

Canvas + screen:

  • nodes canvas snapshot --node <id|name|ip> [--format png|jpg|jpeg] [--max-width <px>] [--quality <0-1>] [--invoke-timeout <ms>]
  • nodes canvas present --node <id|name|ip> [--target <urlOrPath>] [--x <px>] [--y <px>] [--width <px>] [--height <px>] [--invoke-timeout <ms>]
  • nodes canvas hide --node <id|name|ip> [--invoke-timeout <ms>]
  • nodes canvas navigate <url> --node <id|name|ip> [--invoke-timeout <ms>]
  • nodes canvas eval [<js>] --node <id|name|ip> [--js <code>] [--invoke-timeout <ms>]
  • nodes canvas a2ui push --node <id|name|ip> (--jsonl <path> | --text <text>) [--invoke-timeout <ms>]
  • nodes canvas a2ui reset --node <id|name|ip> [--invoke-timeout <ms>]
  • nodes screen record --node <id|name|ip> [--screen <index>] [--duration <ms|10s>] [--fps <n>] [--no-audio] [--out <path>] [--invoke-timeout <ms>]

Location:

  • nodes location get --node <id|name|ip> [--max-age <ms>] [--accuracy <coarse|balanced|precise>] [--location-timeout <ms>] [--invoke-timeout <ms>]

Browser​

Browser control CLI (dedicated Chrome/Brave/Edge/Chromium). See clawdbot browser and the Browser tool.

Common options:

  • --url <controlUrl>
  • --browser-profile <name>
  • --json

Manage:

  • browser status
  • browser start
  • browser stop
  • browser reset-profile
  • browser tabs
  • browser open <url>
  • browser focus <targetId>
  • browser close [targetId]
  • browser profiles
  • browser create-profile --name <name> [--color <hex>] [--cdp-url <url>]
  • browser delete-profile --name <name>

Inspect:

  • browser screenshot [targetId] [--full-page] [--ref <ref>] [--element <selector>] [--type png|jpeg]
  • browser snapshot [--format aria|ai] [--target-id <id>] [--limit <n>] [--interactive] [--compact] [--depth <n>] [--selector <sel>] [--out <path>]

Actions:

  • browser navigate <url> [--target-id <id>]
  • browser resize <width> <height> [--target-id <id>]
  • browser click <ref> [--double] [--button <left|right|middle>] [--modifiers <csv>] [--target-id <id>]
  • browser type <ref> <text> [--submit] [--slowly] [--target-id <id>]
  • browser press <key> [--target-id <id>]
  • browser hover <ref> [--target-id <id>]
  • browser drag <startRef> <endRef> [--target-id <id>]
  • browser select <ref> <values...> [--target-id <id>]
  • browser upload <paths...> [--ref <ref>] [--input-ref <ref>] [--element <selector>] [--target-id <id>] [--timeout-ms <ms>]
  • browser fill [--fields <json>] [--fields-file <path>] [--target-id <id>]
  • browser dialog --accept|--dismiss [--prompt <text>] [--target-id <id>] [--timeout-ms <ms>]
  • browser wait [--time <ms>] [--text <value>] [--text-gone <value>] [--target-id <id>]
  • browser evaluate --fn <code> [--ref <ref>] [--target-id <id>]
  • browser console [--level <error|warn|info>] [--target-id <id>]
  • browser pdf [--target-id <id>]

docs [query...]​

Search the live docs index.

TUI​

tui​

Open the terminal UI connected to the Gateway.

Options:

  • --url <url>
  • --token <token>
  • --password <password>
  • --session <key>
  • --deliver
  • --thinking <level>
  • --message <text>
  • --timeout-ms <ms> (defaults to agents.defaults.timeoutSeconds)
  • --history-limit <n>