阴蒂颌
停止玩弄人工智能编码工具。一次使用所有这些。
](https://npmjs.com/package/cli-jaw) ](https://github.com/lidge-jun/cli-jaw/releases)  ](https://nodejs.org)  ](#-docker)
______________________________________________________________________
什么是CLI-JAW?
CLI-JAW是一个开源平台,它将您已经使用的AI编码CLI(Claude、Codex、Codex App、Gemini CLI、Grok CLI、OpenCode、Copilot CLI)统一到一个具有一个内存和一个仪表板的助手中。您的主CLI将其他人称为“员工”(子代理),因此您可以停止在繁重的应用程序之间复制粘贴,并开始从一个地方下订单。
它通过您已经支付的订阅进行路由。无需支付API账单。在您已有的基础上没有利率限制。
一位开发人员正在用这个东西管理10万多行代码。它基本上是一个超级应用程序:多实例管理器+迷你黑曜石笔记+看板+浏览器自动化,在您的机器上本地运行。
______________________________________________________________________
2.0.0中的新功能
这是常规可用性版本。以下是降落的东西:
| 功能 | 它意味着什么 |
|---|---|
| 经理仪表板 | 一个超级应用程序控制平面。查看每个正在运行的JAW实例,启动/停止/重新启动它们,预览实时Web UI,检查设置——所有这些都可以从一个浏览器选项卡中完成 |
| Notes工作区 | 仪表板上烤了一个迷你黑曜石。文件夹、重命名/移动、拆分编辑器+预览、KaTeX数学、美人鱼图、语法高亮代码块 |
| 看板 | 将正在运行的实例拖动到车道中。卡片编辑器,用于跟踪每个实例正在处理的内容 |
| 员工制度 | 您的主CLI将其他CLI作为worker进行调度。“修复前端”转到OpenCode。“更新API”进入Codex。您批准结果 |
| 响应式移动布局 | 侧边栏覆盖,触摸友好控件。通过手机管理您的车队 |
另外:明确的PABCD编排(/orchestrate, /pabcd, /continue),230多种参考技能、SQLite FTS5内存搜索、cron/avery heartbeat作业和计算机使用桌面自动化。
______________________________________________________________________
最近的架构更新
| 区域 | 更新 |
|---|---|
| Pable | 工作日志简历明确:使用 /continue.自然语言“continue”保持正常提示 |
| Gemini CLI | 完全访问Gemini运行使用 --skip-trust --approval-mode yolo 加 --include-directories 用于操作系统家庭访问;WSL还包括可发现的Windows用户主页 |
| Grok CLI | grok-build 作为标准CLI运行时支持流式json解析。 --effort 故意禁用 grok-build 因为服务器拒绝 reasoningEffort 即使CLI帮助列出了该标志 |
| 消息传递 | /api/channel/send 是规范的Telegram/Discord出站路径;保留传统通道特定端点 |
| 心跳 | 工作支持 every 和 cron 带有可选IANA时区的时间表 |
| 浏览器网络AI | 运行时诊断/孤立清理、持久选项卡生命周期、会话重新连接和ChatGPT/Gemini/Grok供应商路径记录在 structure/ |
| OfficeCLI | Office技能现在将HWP/HWPX分开处理:HWPX是一个稳定的主路径,而二进制HWP是通过rhwp sidecar门控的 officecli hwp doctor --json 和 officecli capabilities --json |
| 释放闸门 | npm run gate:all 在本地开发时运行命名的release/doc奇偶校验 |
______________________________________________________________________
双线安装
已经管理Codex、Gemini、Claude、MCP服务器、OfficeCLI或其他工具的现有用户可以先运行安全更新。安全安装创建 ~/.cli-jaw 仅,跳过可选的工具/运行时设置,让您运行 jaw init 稍后,当您需要交互式设置时。
# macOS/Linux safe update
JAW_SAFE=1 npm install -g cli-jaw# Windows PowerShell safe update
$env:JAW_SAFE="1"; npm install -g cli-jaw正常安装执行完整设置:
npm install -g cli-jaw
jaw dashboard就这样,打开 http://localhost:3457。需要Node.js 22+。
jaw serve如果您更喜欢经典服务器模式,也可以使用。 开机自动启动:jaw service install(自动检测systemd/launchd/Docker)。
______________________________________________________________________
平台设置
macOS — one-click script
- 打开 终端 (
Cmd + Space→ typeTerminal) - 粘贴并按下Enter键:
curl -fsSL https://raw.githubusercontent.com/lidge-jun/cli-jaw/master/scripts/install.sh | bash- 验证(见下文)并启动:
jaw dashboardWindows / WSL — one-click script
步骤1:安装WSL (PowerShell作为管理员)
wsl --install重新启动,然后打开 乌班图 从“开始”菜单。
步骤2:安装CLI-JAW
curl -fsSL https://raw.githubusercontent.com/lidge-jun/cli-jaw/master/scripts/install-wsl.sh | bash步骤3:重新加载并启动
source ~/.bashrc
jaw dashboard安装程序使用用户本地npm前缀(~/.local)并写道 ~/.local/bin 对双方 ~/.bashrc 和 ~/.profile,所以新的Ubuntu shell可以 找到 jaw 以及捆绑的CLI工具。
WSL脚本是集成的Linux设置路径:它验证 jaw --version, 以严格模式请求捆绑的CLI工具,安装OfficeCLI并验证 officecli --version 在报告成功之前。检查浏览器支持后 Chromium/Windows Chrome检测;如果找不到可运行的浏览器,安装程序 打印警告,而不是假装webai/浏览器自动化完全就绪。
WSL Troubleshooting
| 问题 | 修复 |
|---|---|
unzip: command not found | 重新运行安装程序 |
jaw: command not found | 快跑 source ~/.bashrc 或 export PATH="$HOME/.local/bin:$PATH" |
officecli: command not found | 重新运行WSL安装程序或 bash "$(npm root -g)/cli-jaw/scripts/install-officecli.sh" |
| 权限错误 | sudo chown -R $USER $(npm config get prefix) |
Linux
你知道该怎么做。
npm install -g cli-jaw
jaw dashboard通用Linux npm install -g cli-jaw 保留可选助手安装 尽最大努力实现兼容性。当您需要时,使用WSL一键脚本 更严格的集成设置保证,或手动验证:
jaw --version
officecli --version
jaw doctor______________________________________________________________________
验证
你只需要 一。选择您已有的订阅:
# Free options
copilot login # GitHub Copilot (free tier available)
opencode # OpenCode — free models available
# Paid (monthly subscription you already pay for)
claude auth login # Anthropic Claude Max
codex login # OpenAI ChatGPT Pro
gemini # Google Gemini Advanced
grok login --oauth # xAI Grok / Grok Heavy立即检查所有内容: claude auth status && jaw doctor
Example jaw doctor output
🦈 CLI-JAW Doctor — 12 checks
✅ Node.js v22.15.0
✅ Claude CLI installed
✅ Codex CLI installed
⚠️ Gemini CLI not found (optional)
✅ OpenCode CLI installed
✅ Copilot CLI installed
✅ Database jaw.db OK
✅ Skills 32 active, 194 reference
✅ MCP 3 servers configured
✅ Memory structured/ exists
✅ Server port 3457 available______________________________________________________________________
仪表板
仪表板是使用CLI-JAW 2.0的主要方式。它是一个本地web应用程序,充当所有AI实例的指挥中心。
实例管理
导航器面板显示每个JAW实例——运行、停止或脱机。对于每一个,您可以:
- 启动/停止/重新启动 只需单击一下
- 查看活动CLI引擎、型号、端口和工作目录
- 使用 perm模式 对于重启后仍能存活的持久实例
- 启动指向不同项目目录的新实例
实时预览
选择任何正在运行的实例,其Web UI将通过预览代理直接嵌入仪表板中。与你的人工智能聊天,查看流式响应,拖放文件——所有这些都不需要离开经理。
备注
仪表板内有一个标记库。想想迷你黑曜石:
- 具有创建/重命名/移动/删除功能的文件夹树
- 原始、分割和预览编辑模式
- 脏状态标记,这样您就不会丢失未保存的工作
- KaTeX数学渲染、美人鱼图、语法高亮代码块
看板
将实例卡拖入通道(待办事项/就绪/活动/审查/完成)。每张卡都链接到实时实例,并有一个注释编辑器。当您运行多个实例时,有助于跟踪每个AI会话正在处理的内容。
设置检查器
查看和编辑任何选定实例的运行时设置:活动CLI、模型、推理工作、权限模式、工作目录、员工、技能、MCP服务器。
______________________________________________________________________
员工制度如何运作
这是核心思想: 您的主CLI将其他CLI作为worker调用。
你与一个AI(“老板”)交谈。当它需要专门的工作时,它会将任务分派给员工——每个员工都使用自己的模型运行自己的CLI:
You: "Fix the frontend styling and update the API endpoint"
Boss (Claude) thinks...
├── Dispatches to Frontend employee (OpenCode) → "Fix the CSS grid layout in dashboard.tsx"
├── Dispatches to Backend employee (Codex) → "Update /api/users to return pagination metadata"
└── Synthesizes both results for you# Under the hood, it's one command:
jaw dispatch --agent "Frontend" --task "Fix the CSS grid layout in dashboard.tsx"员工是在您的设置中配置的其他AI CLI。每个都有自己的会话、自己的模型和自己的上下文。老板在向你展示之前会审查他们的输出。
员工与次级代理人
这些是不同的东西:
| 员工 | 分代理 | |
|---|---|---|
| 什么 | 其他配置为workers的AI CLI(Codex、OpenCode等) | 在单个CLI中内置并行任务工具 |
| 当 | 跨不同代码库或领域的多专家工作 | 内部研究、文件读取、并行分析 |
| 如何 | jaw dispatch --agent "Name" --task "..." | 自动--CLI在内部生成它们 |
使用员工“前端做CSS,后端做API”。使用子代理“在决定之前并行读取这5个文件”
______________________________________________________________________
AI运行时曲面
无需支付API账单。通过您已经支付的订阅进行路由。
| CLI | 默认模型 | 身份验证 | 成本 |
|---|---|---|---|
| 克劳德 | opus-4-6 | claude auth login | Claude Max订阅 |
| 法典 | gpt-5.5 | codex login | ChatGPT Pro订阅 |
| Codex应用程序 | gpt-5.4 | codex login | ChatGPT Pro订阅 |
| 双子座 | gemini-3.1-pro-preview | gemini | Gemini高级订阅 |
| 格罗克 | grok-build | grok login --oauth | Grok认购;配额仅用于身份验证/状态 |
| 开源代码 | minimax-m2.7 | opencode | 提供免费型号 |
| 副驾驶 | gpt-5-mini | copilot login | 免费套餐可用 |
后备链:如果一台发动机的转速受到限制,下一台发动机就会启动。配置为 /fallback [cli1 cli2...].
OpenCode通配符:连接任何模型端点-OpenRouter、本地LLM、任何与OpenAI兼容的API。
切换发动机带电状态:/cli codex.开关型号:/model gpt-5.5。适用于Web、终端、电报或Discord。
______________________________________________________________________
PABCD编排
对于复杂的任务,CLI-JAW使用5阶段工作流。你批准每一个过渡。
P (Plan) → A (Audit) → B (Build) → C (Check) → D (Done) → IDLE
⛔ ⛔ ⛔ auto auto| 阶段 | 发生了什么 |
|---|---|
| P——计划 | 老板写了一份不同级别的计划。停下来复习 |
| A--审计 | 只读工作者验证计划是否可行(导入存在,签名匹配) |
| B--构建 | 老板执行。只读工作者验证结果 |
| C--检查 | 类型检查(tsc --noEmit),文档更新,一致性检查 |
| D--完成 | 所有变更的摘要。返回空闲状态 |
状态是DB持久化的,并在重新启动后仍然存在。工作人员不能修改文件,只能验证。通过以下方式激活 jaw orchestrate, /orchestrate,或 /pabcd;使用以下命令显式恢复活动工作日志 /continue.
______________________________________________________________________
记忆
三层,每层覆盖不同的回忆范围。
| Layer | 它存储什么 | 它是如何工作的 |
|---|---|---|
| 历史记录块 | 最近会话上下文 | 最近10个会话,最多8000个字符,作用域为工作目录。快速启动时注射 |
| 内存刷新 | 对话中的结构化知识 | 阈值后触发(默认10圈)。提取剧集、每日日志、语义注释作为标记 |
| 灵魂+任务快照 | 身份和语义回忆 | 核心价值观、语气、界限。FTS5索引每个提示最多返回4个语义相关的点击 |
所有三层都会自动输入系统提示。内存是可搜索的:
jaw memory search "how did we set up the API auth?"______________________________________________________________________
技能
230多种技能,涵盖开发工作流程、办公文档、自动化和媒体。
| 类别 | 技能 | 涵盖内容 |
|---|---|---|
| 办公室 | pdf, docx, xlsx, pptx, hwp | 阅读、创建、编辑文档。HWPX是稳定的韩国文件路径;二进制HWP支持rhwp,并通过OfficeCLI进行能力门控 |
| 自动化 | browser, vision-click, screen-capture, desktop-control | Chrome CDP、人工智能坐标点击、macOS截图、计算机使用 |
| 媒体 | video, imagegen, lecture-stt, tts | 远程视频、OpenAI图像生成、讲座转录、文本转语音 |
| 整合 | github, notion, telegram-send, memory | 问题/PR/CI、通知页面、电报媒体传递、持久内存 |
| 可视化 | diagram | SVG图表、图表、聊天中呈现的交互式可视化 |
| 开发指南 | dev, dev-frontend, dev-backend, dev-data, dev-testing, dev-pabcd | 将工程指南注入代理提示中 |
参考技能生活 skills_ref/ 并按需安装到活动运行时中;活动技能从用户运行时主页加载。
jaw skill install # activate a reference skill
jaw skill list # see what's available______________________________________________________________________
浏览器和桌面自动化
| 能力 | 它是如何工作的 | ||
|---|---|---|---|
| Chrome CDP | 导航、单击、键入、截图、评估JS、滚动、按键——完全的DevTools协议控制 | ||
| 视觉点击 | 屏幕截图→ AI提取目标坐标→ 点击。 jaw browser vision-click "Login button" | ||
| 计算机使用 | 通过Codex计算机使用MCP实现桌面应用程序自动化。将Safari用于本地主机,感觉就像Codex应用程序 | ||
| Web AI供应商 | `jaw browser web-ai --vendor chatgpt\ | gemini\ | grok` 在实现会话生命周期、诊断和源审计/应答工件支持的地方 |
| 图表技能 | 生成SVG图表和交互式可视化,在聊天中内联呈现 |
计算机使用允许您通过自然语言控制任何macOS应用程序——Finder、Safari、系统设置、Xcode。将其指向Safari中的本地主机开发服务器,您将获得一个完整的可视化测试循环。
______________________________________________________________________
消息传递
电报
📱 Telegram ←→ 🦈 CLI-JAW ←→ 🤖 AI Engines文本聊天、语音信息(通过多提供商STT自动转录)、文件/照片上传、斜线命令(/cli, /model, /status),通过以下方式安排任务交付 every/cron 心跳作业。
Setup (3 steps)
- 消息 @植物学家 →
/newbot→ 复制令牌 jaw init --telegram-token YOUR_TOKEN或使用Web UI设置- 向您的机器人发送任何消息。聊天ID会在第一条消息中自动保存
Discord 的中文翻译是“不和谐”或“纷争”。
与Telegram相同的功能——文本、文件、命令。通道/线程路由,规范 /api/channel/send,以及对代理结果广播的转发器支持。通过Web UI设置进行设置。
语音和STT
语音输入适用于网络(麦克风按钮)、电报(语音信息)和Discord。提供者:兼容OpenAI、Google Vertex AI或任何自定义端点。
______________________________________________________________________
主控程序
模型上下文协议 允许AI代理使用外部工具。CLI-JAW从一个文件管理受支持的MCP感知引擎的MCP配置。
jaw mcp install @anthropic/context7
# → syncs to Claude, Codex, Gemini, OpenCode, Copilot config files simultaneously不再编辑多个不同的JSON文件。安装一次,每个支持MCP的引擎都会得到它。Grok CLI是这里的标准运行时,但在Grok公开兼容的配置界面之前,它不被视为支持MCP同步。
jaw mcp sync # re-sync after manual edits______________________________________________________________________
CLI命令
# Core
jaw dashboard # launch manager dashboard
jaw serve # start server (http://localhost:3457)
jaw chat # terminal TUI
jaw doctor # 12-point diagnostics
# Instances
jaw clone ~/project # clone instance to new directory
jaw --home ~/project serve --port 3458 # run second instance
jaw service install # auto-start on boot
# AI & Orchestration
jaw dispatch --agent "Backend" --task "..." # dispatch employee
jaw orchestrate # enter/control PABCD workflow
# in chat: /continue # explicit worklog/PABCD resume
# Skills & MCP
jaw skill install # activate a skill
jaw skill list # list available skills
jaw mcp install
# install MCP → syncs supported MCP-aware engines
jaw mcp sync # re-sync MCP configs
# Memory
jaw memory search # search across all memory layers
jaw memory save # save to structured memory
# Browser
jaw browser start # launch Chrome (CDP)
jaw browser fetch "https://example.com" --json --trace # adaptive URL reader
jaw browser snapshot # capture page state
jaw browser vision-click "Login" # AI-powered click
# Maintenance
jaw reset # full reset______________________________________________________________________
多实例和Docker
多实例
使用单独的设置、内存和数据库运行独立的实例:
jaw clone ~/my-project
jaw --home ~/my-project serve --port 3458每个实例都是完全独立的——不同的工作目录、不同的内存、不同的MCP配置。经理仪表板可以看到所有这些。
码头工人
docker compose up -d # → http://localhost:3457非根 jaw 用户,Chromium沙盒已启用。数据持续存在 jaw-data 命名卷。
Docker details
# Dev build
docker build -f Dockerfile.dev -t cli-jaw:dev .
docker run -d -p 3457:3457 --env-file .env cli-jaw:dev
# Pin version
docker build --build-arg CLI_JAW_VERSION=2.0.0 -t cli-jaw:2.0.0 .
# If Chromium sandbox fails
docker run -e CHROME_NO_SANDBOX=1 -p 3457:3457 cli-jaw______________________________________________________________________
发展
npm run build # tsc → dist/
npm run dev # tsx server.ts (hot-reload)
npm test # native Node.js test runner
npm run gate:all # named release/docs parity gates架构细节: 建筑.md ·测试覆盖范围: TESTS.md ·内部结构文档: 结构/
______________________________________________________________________
如何比较
| CLI-JAW 2.0 | 爱马仕代理商 | 克劳德代码 | |
|---|---|---|---|
| 模型访问 | Claude、Codex、Codex应用程序、Gemini、Grok、OpenCode和Copilot通过支持的供应商身份验证 | API密钥(OpenRouter 200+,Nous门户) | 仅限Anthropic |
| 成本模型 | 您已经支付的月度订阅 | Per-token API账单 | Anthropic订阅 |
| 主UI | 管理器仪表板+Web PWA+Mac应用程序+TUI | 仅限TUI | CLI+IDE插件 |
| 仪表板 | 多实例管理器、看板、Notes工作区 | 无 | 无 |
| 消息传递 | Telegram(语音)+Discord | Telegram/Discord/Slack/WhatsApp/Signal | 无 |
| 记忆 | 3层(历史/刷新/灵魂)+SQLite FTS5 | 自改进循环+Honcho | 基于文件的自动内存 |
| 多代理 | 员工系统(调度其他CLI)+PABCD | 子代理生成 | 任务工具 |
| 浏览器自动化 | Chrome CDP+视觉点击+电脑使用 | 受限 | 通过MCP |
| 执行 | 本地+Docker | 本地/Docker/SSH/Daytona/Modal | 本地 |
| 技能 | 230+捆绑 | 自我创建+agentskills.io | 用户配置 |
| 国际化 | 英语、韩语、中文、日语 | 英语 | 英语 |
______________________________________________________________________
故障排除
| 问题 | 解决方案 |
|---|---|
cli-jaw: command not found | npm install -g cli-jaw 再一次。检查 ~/.local/bin 或 npm bin -g 在...里 $PATH |
Error: node version | 升级到Node.js 22+: nvm install 22 |
NODE_MODULE_VERSION 不匹配 | npm run ensure:native (自动重建本机模块) |
EADDRINUSE: port 3457 | 另一个实例正在运行。使用 --port 3458 或者先停止它 |
| 电报/Discord身份验证失败 | 运行 jaw doctor,检查令牌,重新启动 jaw serve |
| 浏览器命令失败 | 安装Chrome/Chromium。跑 jaw browser start 首先 |
| 员工调度挂起 | 确保员工CLI经过身份验证(jaw doctor) |
| 计算机使用不起作用 | 仅限macOS。需要Codex CLI。在系统设置中检查自动化权限 |
______________________________________________________________________
贡献
- 叉和分支从
master npm run build && npm test- 提交PR
Bug报告和功能想法: 打开一个问题
______________________________________________________________________
MIT许可证 ·由厌倦了AI应用程序之间标签切换的开发人员构建。
