阴蒂颌
停止玩弄人工智能编码工具。一次使用所有这些。
英语 / 韩语 / 中文 / 日本语
什么是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 稍后,当您需要交互式设置时。```bash
macOS/Linux safe update
JAW_SAFE=1 npm install -g cli-jaw
``````powershell
Windows PowerShell safe update
$env:JAW_SAFE="1"; npm install -g cli-jaw
正常安装执行完整设置:```bash
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键:```bash
curl -fsSL https://raw.githubusercontent.com/lidge-jun/cli-jaw/master/scripts/install.sh | bash
3. 验证(见下文)并启动:```bash
jaw dashboard
Windows / WSL — one-click script
步骤1:安装WSL (PowerShell作为管理员)```powershell
wsl --install
重新启动,然后打开 **乌班图** 从“开始”菜单。
**步骤2:安装CLI-JAW**```bash
curl -fsSL https://raw.githubusercontent.com/lidge-jun/cli-jaw/master/scripts/install-wsl.sh | bash
步骤3:重新加载并启动```bash
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
你知道该怎么做。```bash
npm install -g cli-jaw
jaw dashboard
通用Linux npm install -g cli-jaw 保留可选助手安装
尽最大努力实现兼容性。当您需要时,使用WSL一键脚本
更严格的集成设置保证,或手动验证:```bash
jaw --version
officecli --version
jaw doctor
______________________________________________________________________
## 验证
你只需要 **一**。选择您已有的订阅:```bash
# 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
``````bash
# 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个语义相关的点击|
所有三层都会自动输入系统提示。内存是可搜索的:```bash
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/ 并按需安装到活动运行时中;活动技能从用户运行时主页加载。```bash
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会在第一条消息中自动保存
与Telegram相同的功能——文本、文件、命令。通道/线程路由,规范 /api/channel/send,以及对代理结果广播的转发器支持。通过Web UI设置进行设置。
语音和STT
语音输入适用于网络(麦克风按钮)、电报(语音信息)和Discord。提供者:兼容OpenAI、Google Vertex AI或任何自定义端点。
主控程序
模型上下文协议 允许AI代理使用外部工具。CLI-JAW从一个文件管理受支持的MCP感知引擎的MCP配置。```bash
jaw mcp install @anthropic/context7
→ syncs to Claude, Codex, Gemini, OpenCode, Copilot config files simultaneously
不再编辑多个不同的JSON文件。安装一次,每个支持MCP的引擎都会得到它。Grok CLI是这里的标准运行时,但在Grok公开兼容的配置界面之前,它不被视为支持MCP同步。```bash
jaw mcp sync # re-sync after manual edits
CLI命令```bash
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
### 多实例
使用单独的设置、内存和数据库运行独立的实例:```bash
jaw clone ~/my-project
jaw --home ~/my-project serve --port 3458
每个实例都是完全独立的——不同的工作目录、不同的内存、不同的MCP配置。经理仪表板可以看到所有这些。
码头工人```bash
docker compose up -d # → http://localhost:3457
非根 `jaw` 用户,Chromium沙盒已启用。数据持续存在 `jaw-data` 命名卷。
Docker details```bash
# 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
发展```bash
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应用程序之间标签切换的开发人员构建。
