Root CLI 子命令

在前台启动 CLI-JAW 服务器。在 chat、dispatch、browser 及大多数其他命令运行之前，服务器必须处于运行状态。

jaw serve [--port <N>] [--no-open] [--lan] [--remote]

示例

# 使用默认配置启动（端口 3457，自动打开浏览器）
jaw serve

# 自定义端口，不打开浏览器
jaw serve --port 3458 --no-open

# 局域网模式，用于本地网络访问
jaw serve --lan --port 3460

# 使用单独的数据目录
jaw --home ~/.cli-jaw-work serve --port 3458

多实例管理器。启动仪表盘服务器、列出/启动/停止实例、管理持久化服务，并执行 L2 跨实例记忆联邦搜索。

jaw dashboard <command> [options] [--json]

示例

# 启动仪表盘
jaw dashboard serve

# 以 JSON 格式列出在线实例
jaw dashboard ls --json | jq '.[] | select(.status == "online")'

# 在端口 3458 上启动新实例
jaw dashboard start 3458 --home ~/.jaw-work

# 停止实例
jaw dashboard stop 3457

# 跨实例记忆搜索
jaw dashboard memory search "JWT authentication"

# 列出所有记忆实例
jaw dashboard memory instances

# 注册为持久化自动启动
jaw dashboard perm 3458 --home ~/.jaw-work

通过 ping API 检查 jaw 服务器是否正在运行。可选同时检查仪表盘服务器。

jaw status [--port <N>] [--json] [--dashboard]

退出码 0 = 服务器正在运行，1 = 服务器未运行或出错。

示例

# 快速健康检查
jaw status

# 用于脚本的 JSON 输出
jaw status --json
# → {"status":"running","port":"3457","cli":"claude"}

# 同时检查服务器和仪表盘
jaw status --dashboard

# 检查指定端口
jaw status --port 3458

用于首次配置的交互式设置向导。创建 ~/.cli-jaw/settings.json，配置默认 CLI 后端、消息通道和技能目录。

jaw init [options]

示例

# 交互式向导（推荐首次运行时使用）
jaw init

# 使用默认值的非交互模式
jaw init --non-interactive --cli claude

# 强制重新初始化
jaw init --force --cli gemini --channel telegram

# 预览将要创建的内容
jaw init --dry-run

诊断安装和配置健康状况。检查 Node.js 版本、CLI 二进制文件解析、设置文件有效性、MCP 服务器连接性、员工 CLI 可用性和端口可用性。

jaw doctor [--json] [--fix] [--tcc] [--prime]

示例

# 运行诊断
jaw doctor

# 机器可读输出
jaw doctor --json

# 自动修复检测到的问题
jaw doctor --fix

# 检查 macOS 辅助功能权限
jaw doctor --tcc

恢复出厂设置：执行 MCP 同步、技能重置、员工重置和会话清除。除非传入 --yes，否则会提示确认。需要服务器正在运行。

jaw reset [--yes] [--port <N>]

示例

# 带确认提示的重置
jaw reset

# 跳过确认（用于脚本）
jaw reset --yes

# 重置指定实例
jaw reset --port 3458 --yes

交互式终端 REPL。通过 SSE-first TUI 通道连接正在运行的服务器，旧版服务器使用 legacy WebSocket fallback。支持带有持久底栏的富 TUI 模式、用于 UI 集成的原始 JSON 协议模式，以及最简化的纯 readline 模式。

jaw chat [--port <N>] [--raw] [--simple]

示例

# 默认富 TUI 模式
jaw chat

# 简单模式（适用于简易终端）
jaw chat --simple

# 连接到不同的实例
jaw chat --port 3458

# 用于管道的原始 JSON 模式
jaw chat --raw

向员工代理发送任务。员工通过服务器 API 异步运行，并通过 stdout 返回结果。兼容管道，便于脚本化工作流。需要 JAW_BOSS_TOKEN（从服务器进程继承）。

jaw dispatch --agent <name> --task <text> [--json] [--port <N>]

示例

# 分派前端任务
jaw dispatch --agent "Frontend" --task "Fix CSS bug in the header component"

# 分派后端任务
jaw dispatch --agent "Backend" --task "Add rate limiting to /api/chat endpoint"

# 用于管道的 JSON 输出
jaw dispatch --agent "Data" --task "Optimize the slow query in reports" --json

员工管理工具。目前支持将员工重置为默认的 5 个配置文件（Frontend、Backend、Data、Docs、QA）。

jaw employee <subcommand> [--port <N>]

示例

# 将所有员工重置为默认值
jaw employee reset

# 在指定实例上重置
jaw employee reset --port 3458

PABCD 状态机转换。驱动工作流经历面谈、规划、审计、构建、检查和完成各阶段。它调用运行中服务器的 API，因此 SSE-first 事件更新会实时发送到已连接的客户端。

jaw orchestrate <phase> [--force] [--json] [--port <N>]

有效转换：IDLE → I → P → A → B → C → D → IDLE。面谈阶段是可选的：IDLE → P 也是有效的。

示例

# 开始规划阶段
jaw orchestrate P

# 强制转换（跳过验证）
jaw orchestrate B --force

# 检查当前状态
jaw orchestrate status

# 重置为 IDLE
jaw orchestrate reset

# JSON 输出
jaw orchestrate status --json

持久化目标生命周期管理。设置目标、通过检查点跟踪进度、管理目标状态（暂停、恢复、取消、完成）。目标在跨会话和服务器重启后依然保留。

jaw goal <subcommand> [args...] [--port <N>]

示例

# 设置新目标
jaw goal set "Implement keyboard shortcuts for the editor"

# 查看当前目标
jaw goal status

# 添加进度检查点
jaw goal update "K0: shortcut registry done, K1: in progress"

# 标记完成
jaw goal done "All phases complete, PR merged"

# 查看过去的目标
jaw goal history 5

# 暂停和恢复
jaw goal pause
jaw goal resume

# 附带原因取消
jaw goal cancel "Deprioritized in favor of auth refactor"

持久化记忆存储 CLI。搜索、读取、保存和列出记忆文件。记忆以 Markdown 文件形式存储在 ~/.cli-jaw/memory/ 中，并被索引以支持语义搜索。

jaw memory <subcommand> [args...]

示例

# 搜索记忆
jaw memory search "JWT authentication patterns"

# 读取指定文件
jaw memory read structured/profile.md

# 保存新的记忆条目
jaw memory save structured/profile.md "- User prefers concise Korean summaries"

# 保存事件日志
jaw memory save structured/episodes/live/2026-05-29.md "## 14:30\n- Completed CLI docs page"

# 列出所有文件
jaw memory list

通过 CDP（Chrome DevTools Protocol）控制 Chrome 浏览器。打开页面、截屏、点击元素、输入文本、管理标签页，并执行 Web AI 驱动的浏览。需要服务器正在运行。

jaw browser <subcommand> [args...]

示例

# 检查浏览器状态
jaw browser status

# 打开页面并截屏
jaw browser open https://example.com
jaw browser screenshot

# 获取页面快照以获取元素 ref
jaw browser snapshot

# 使用 ref 点击和输入
jaw browser click ref:42
jaw browser type ref:15 "search query"

# 自适应获取
jaw browser fetch https://example.com/api/data

技能管理：列出已安装的技能、从参考目录/Codex/GitHub 安装、移除技能和查看技能详情。技能会被注入到代理的系统提示中。

jaw skill [subcommand] [name...]

示例

# 列出已安装的技能
jaw skill

# 安装技能
jaw skill install cloudflare
jaw skill install docker kubernetes terraform

# 移除技能
jaw skill remove cloudflare

# 查看技能详情
jaw skill info dev-frontend

# 重置为默认值
jaw skill reset

MCP（Model Context Protocol）服务器管理。安装 npm/PyPI MCP 包、将配置同步到所有 6 个 CLI 后端、列出已注册的服务器或重置为默认值。

jaw mcp [subcommand] [package]

包生态系统会自动检测：@scope/name 为 npm；mcp-server-* 为 PyPI。使用 --pypi 或 --npm 可手动覆盖。

示例

# 列出所有 MCP 服务器
jaw mcp

# 安装 npm MCP 包
jaw mcp install @anthropic/mcp-server-fetch

# 安装 PyPI MCP 包
jaw mcp install mcp-server-git

# 将配置同步到所有 CLI
jaw mcp sync

# 重置为默认 MCP 服务器
jaw mcp reset --force

仪表盘连接器 CLI——看板、笔记、提醒和审计日志的统一入口。无需 Web UI 即可直接通过 CLI 访问仪表盘功能。

jaw connector <surface> <subcommand> [options]

示例

# 添加看板任务
jaw connector board add --title "Implement auth flow" --lane backlog

# 将任务移至完成
jaw connector board update task-id-123 --lane done

# 列出看板任务
jaw connector board list --json

# 写笔记
jaw connector notes write --path "meeting/standup.md" --body "# Standup Notes\n- Auth PR merged"

# 列出笔记
jaw connector notes list

# 添加提醒
jaw connector reminders add --title "Review PR #42" --priority high --due 2026-06-01

基于优先级的提醒，采用艾森豪威尔矩阵式分类。是 jaw connector reminders 的快捷方式。

jaw reminders <subcommand> [options]

示例

# 列出提醒
jaw reminders list

# 添加提醒
jaw reminders add "Review PR #42" --priority high --due 2026-06-01

# 附带备注添加
jaw reminders add --title "Deploy staging" --notes "After QA sign-off" --priority normal

# 标记完成
jaw reminders done reminder-id-abc

# JSON 输出
jaw reminders list --json

管理项目工作区目录。设置代理应将哪些目录视为活跃项目根目录。更改通过服务器 API 应用，并在跨会话中持久保存。

jaw project <subcommand> [paths...]

示例

# 设置项目目录
jaw project set ~/Dev/frontend, ~/Dev/backend

# 设置单个绝对路径
jaw project set /Users/jun/projects/my-app

# 列出当前目录
jaw project list

# 清除全部
jaw project reset

跨平台自动启动管理。检测操作系统并将服务器安装为后台守护进程（macOS 上使用 launchd、Linux 上使用 systemd、容器中使用 Docker 入口点）。一步安装并启动。

jaw service [subcommand] [--port <N>] [--backend <type>]

示例

# 一步安装并启动（自动检测操作系统）
jaw service

# 自定义端口
jaw service --port 3458

# 检查服务状态
jaw service status

# 查看日志
jaw service logs

# 移除服务
jaw service unset

# 强制指定后端
jaw service --backend systemd --port 3457

通过克隆当前配置创建独立的代理实例。复制配置和技能、创建全新数据库并重新生成 AGENTS.md。适用于运行多个隔离的代理。

jaw clone <target-dir> [--from <source>] [--with-memory] [--link-ref]

示例

# 克隆到新目录
jaw clone ~/.cli-jaw-work

# 带记忆克隆
jaw clone ~/.cli-jaw-research --with-memory

# 从指定源克隆
jaw clone ~/.cli-jaw-staging --from ~/.cli-jaw-prod

# 符号链接参考技能以节省空间
jaw clone ~/.cli-jaw-dev --link-ref

macOS 专用 LaunchAgent 管理（已弃用——请使用 jaw service 代替）。管理 plist 文件以实现登录时自动启动。为向后兼容而保留。

jaw launchd [subcommand] [--port <N>]

示例

# 一步安装并启动
jaw launchd

# 自定义端口
jaw launchd --port 3458

# 检查状态
jaw launchd status

# 移除
jaw launchd unset

# 清理旧版 plist
jaw launchd cleanup