Ouijit
基于 git worktree 的任务与终端管理器,让你并行驱动 Claude Code、Codex、Pi 和 OpenCode 编码代理。
- Star 数
- ★ 184
- 最近更新
- 今天
- License
- AGPL-3.0
- 主语言
- TypeScript
- FA 评分
- 76/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 并行开发多个功能的独立开发者:每张卡片一个 worktree,同时让多个代理在互不冲突的分支上工作。
- 不适合
- 只使用 Windows 的开发者
- 不想在本机安装并登录任何 agent CLI 的用户
- 需要团队托管看板或多设备同步的团队(数据仅本地 SQLite 存储)
- 官网
- ouijit.com ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-21
- 源码审查
- 76/100 · 表现良好
这个 Agent 能做什么,适合哪些场景?
Ouijit 是一个免费开源(AGPL-3.0)的桌面应用,用于并行运行多个编码代理。每张任务卡片对应一个独立的 git worktree 和一个集成终端;开始任务时由生命周期钩子以任务提示词启动代理。内置的 ouijit CLI 挂在每个终端的 PATH 上,让代理能自己创建任务、移动看板卡片和打开面板。看板提供 To Do、In Progress、In Review 和 Done 四列,diff、pull request 和 issues 审阅都在同一窗口内完成,diff 行上的批注会送达该 worktree 中工作的代理。所有数据存储在本地 SQLite,无需账号、无遥测,代理可在沙箱中运行。
任务以看板卡片形式管理;拖动卡片跨列会触发对应的生命周期钩子,开始任务即创建隔离的 git worktree(保留 node_modules 等被 gitignore 文件的写时复制克隆,或干净检出),支持从父分支链式派生任务和按任务设置合并目标。每个任务配一个终端,面板以标签页形式附加:dev server 运行器、Web 预览、带 Mermaid 图的 Markdown 文件。claude、codex、pi、opencode 在 Ouijit 终端内解析为真实二进制的包装器,注入状态钩子和 ouijit CLI 参考。CLI 子命令如 ouijit task create、ouijit task set-status 5 in_review、ouijit hook set start、ouijit pr draft add、ouijit markdown add、ouijit preview add 让代理和用户都能操控应用;外壳 JSON 输出。每个任务终端内置 worktree 对合并目标的 diff(词级高亮),行批注会随代码移动重新锚定并交给代理;实验性 GitHub 面板通过 gh CLI 提供 PR 收件箱与合并,issues 列表可接入 GitHub 和 Linear。⌘K 命令面板在终端、项目、任务和 PR 之间跳转。沙箱由 nono 在 Seatbelt/Landlock 下实现,可用 ouijit sandbox -- claude … 对单条命令启用。退出时保存会话,下次启动可恢复终端与面板。
- 并行开发多个功能的独立开发者:每张卡片一个 worktree,同时让多个代理在互不冲突的分支上工作。
- 给代理留下代码审阅意见的开发者:在 diff 行上写批注,自动送达该 worktree 中正在工作的代理。
- 把 issue 转成任务的维护者:从 GitHub 或 Linear 拉取 issues 列表,一键创建带建议分支名的任务。
- 担心代理权限过大的用户:用 nono 沙箱运行代理,而 dev server 仍留在宿主机。
- 希望代理自主整理工作的用户:代理可通过
ouijit task create建后续任务、移动自己的卡片、在自己旁边打开计划面板。
如何安装或部署这个 Agent?
下载对应平台的最新发布包(自带运行时,自成一体):
- macOS (Apple Silicon): https://github.com/ouijit/ouijit/releases/latest/download/ouijit-darwin-arm64.dmg
- macOS (Intel): https://github.com/ouijit/ouijit/releases/latest/download/ouijit-darwin-x64.dmg
- Linux (x64): https://github.com/ouijit/ouijit/releases/latest/download/ouijit-linux-x64.zip系统要求:macOS 13+(Apple Silicon 或 Intel)或 Linux x64,PATH 上需有 git 2.20+,且至少安装并登录一个代理 CLI(claude、codex、pi 或 opencode)。PR 与 issues 面板另需 gh 2.48+ 并执行 gh auth login。
从源码构建需要 Node.js 22.22+ 和 node-pty 所需的 C/C++ 构建工具(macOS: xcode-select --install;Debian/Ubuntu: sudo apt install build-essential python3):
git clone https://github.com/ouijit/ouijit.git
cd ouijit
npm install
npm start如何使用这个 Agent?
启动 Ouijit,添加一个项目,在看板上创建任务。开始任务会创建 git worktree 并打开终端;配置钩子让代理随任务启动:
ouijit hook set start --name "Agent" --command 'claude "$OUIJIT_TASK_DESCRIPTION"'之后在任意 Ouijit 终端(或你自己的 shell,输出为 JSON)使用 ouijit CLI:
ouijit task create "Fix flaky login test"
ouijit task set-status 5 in_review
ouijit pr draft add 116 --file src/api.ts --line 88 --body "throws when the token is missing"
ouijit theme use dracula
ouijit markdown add ./plan.md
ouijit preview add http://localhost:3000用 ⌘K(Linux 上 Ctrl+K)在终端、项目、任务和 PR 之间跳转;在 diff 行上写批注即可交给该 worktree 的代理;用 ouijit sandbox -- claude … 在沙箱中运行代理。退出时保存会话,下次启动可恢复。
这个 Agent 有哪些优点和局限?
- 每个任务自动获得隔离的 git worktree,多代理可并行工作而互不覆盖分支。
ouijitCLI 让代理自己建任务、移动卡片、打开面板,无需额外配置。- diff 行批注直接送达该 worktree 的代理并随代码移动重新锚定,审阅与编码闭环在同一窗口。
- 完全本地存储(SQLite),无账号、无遥测;代理可在 nono 沙箱中受限运行。
- 支持 Claude Code、Codex、Pi、OpenCode 四种 harness,且不改变代理在终端外的行为。
- 仅支持 macOS 13+ 和 Linux x64,Windows 无发布包。
- 必须安装并登录至少一个受支持的代理 CLI 才有实际价值,模型/订阅费用自理。
- 不接受外部 Pull Request,只能阅读源码或 fork;bug 与功能请求走 issue tracker。
- PR 收件箱与合并依赖
ghCLI 且属实验性功能;issues 集成限于 GitHub 和 Linear。 - GitHub 面板需要 gh 2.48+ 并完成
gh auth login,多一层配置。
这个 Agent 与同类方案有什么区别?
README 明确支持的代理 harness 包括 Claude Code、Codex、Pi 和 OpenCode;Ouijit 与它们不是竞争关系,而是把它们作为并行编排、worktree 隔离和看板管理之上的运行目标。任何其他 harness 需通过 issue 提出支持请求。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Ouijit 当前 | 76 · 表现良好 | 桌面应用免费 + 模型费 | ★ 184 | 今天 | TypeScript | Codex · Claude Code |
| Prometeu | 73 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 67 | 1 天前 | Rust | Codex · Claude Code |
| Skiff | 72 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 21 | 今天 | Rust | Codex · Claude Code |
| Agentbox | 66 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 451 | 今天 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示:项目提供基于 nono 的沙箱(Seatbelt/Landlock),每个终端/钩子/命令可选沙箱,GitHub 工作流声明 permissions: contents: read,review 评论先暂存本地再发送;这些都支持最小权限与外部效果得分。扣分点:本地 REST API 允许代理自主建任务、移动卡片、切换主题,未见强制用户确认门控;无 telemetry 的声明仅是 README 断言,包内未见代码佐证;对 merge、任务删除等操作未提供恢复/回滚机制说明;gh/Linear 凭据依赖外部 CLI 但包内无具体处理证据。
证据显示:README、AGENTS.md、package.json 脚本与 CI 工作流相互一致(docs:check 保证文档同步,checks.yml 说明 E2E 不进 CI 的原因);CLI 端将 ApiError 统一转为 stderr 消息与非零退出码。扣分点:postinstall 需联网下载 nono 二进制,属于安装期外部依赖;集成测试在 CI 中因缺 git identity 被跳过(#63),可靠性覆盖不全。
证据显示:目标场景非常明确(并行运行 Claude Code/Codex/Pi/OpenCode 的开发者),环境要求详尽(macOS 13+/Linux x64、git 2.20+、gh 2.48+、Node 22.22+、构建工具)。扣分点:代理能力边界未系统枚举(哪些命令代理可自主执行、哪些需要人确认未划分);SKILL.md 触发条件写得很细但仅为样本,整体触发精度只能部分评估。
证据显示:AGPL-3.0 许可证全文在场且与 README 一致;安装说明完整(二进制下载+源码构建);信息架构清晰(任务/终端/面板/CLI/沙箱分层)。扣分点:package.json 的 description("Discover and manage your local development projects")与 README 描述不一致;FAQ 与完整文档在外部网站,包内未见;无 CHANGELOG 文件(仅有版本号与自动更新说明);维护模式为仅收 issue 不收 PR,责任主体为未验证的作者 pbjer。
证据显示:CLI 统一 JSON 输出、stderr 报错、非零退出码,可用性好;以 git worktree 隔离任务并集成代理终端是差异化的实际价值。扣分点:成本收益只能静态推断——安装需要下载非本地构建的 nono 二进制、依赖多个外部代理 CLI,实际收益需运行验证;未运行的 E2E 行为(作者自己承认在 GitHub runner 上未知)是已知成本。
证据显示:README 主张(本地 SQLite、gh 驱动、CLI 命令)与 package.json、源码、工作流多处相互印证,交叉佐证充分;docs:check 脚本确保文档与命令一致。扣分点:无 telemetry、copy-on-write 克隆等部分主张在提供的文件内无法追溯到实现;事实与推断的边界未在文档中明确标注。
- 本地 REST API 允许代理自主建任务、移动卡片和切换主题,未见强制确认门控;企业环境部署前应评估是否需要关闭或收紧该接口。
- postinstall 会从网络下载 nono 沙箱二进制,供应链来源应在生产使用前自行审计。
- 无 telemetry 的声明仅为 README 断言,本包内未提供实现级证据,敏感环境请以网络流量验证为准。
- merge 与任务删除等操作未提供文档化的恢复路径,重要分支请自留备份。
- package.json 描述与 README 不一致,且无 CHANGELOG,评估版本间行为变化时依赖外部 release notes。
常见问题
Ouijit 本身收费吗?
代理能访问我整台机器吗?
ouijit sandbox -- claude … 只对单条命令启用,代理受限运行而 dev server 留在宿主机。数据存在哪里?
支持哪些操作系统和代理?
可以贡献代码吗?
Ouijit 官网是什么?
Ouijit 开源吗?
Ouijit 安全吗?
Ouijit 还在维护吗?
Ouijit 是谁开发的?
谢谢反馈,我们会据此改进页面。