dominikmartn/harp

Run many Claude Code and Codex agents side by side, in one sidebar that tells you which one needs you. An unofficial fork of Warp.

什么是 Harp？

Harp 是一款 macOS 终端应用，基于开源 Warp 终端构建。它将 Warp 的横向标签栏替换为侧边栏，专门设计用于显示 Claude Code 和 Codex 等长时间运行的 AI 编码代理的状态。终端的其余部分与上游 Warp 完全一致——你仍然可以获得其快速渲染、云端备份会话和内置 AI 功能——但 Harp 增加了一个 UI 层，使得跟踪多个 AI 驱动的编码会话更加容易。

核心功能

功能	说明
带代理状态的侧边栏	每一行代表一个 Claude Code 或 Codex 会话。图标显示代理是正在工作、等待你、已完成，还是在后台运行。未读活动会一直高亮显示，直到你查看为止。
组标签	可以将标签放入命名组中。当可选的 tmux 集成启用时，组名、顺序和标志会存储在 tmux 中，因此布局在重启后仍能保留，并与其他 tmux 客户端共享。
限额环页脚	底部的小环显示 Claude 和 Codex 的 5 小时和周使用限额。数字从你保持最新的本地 JSON 文件中读取；Harp 不会为此联系任何外部服务。
移动端友好的 tmux 集成	当 tmux 会话在其他地方（例如通过手机 SSH）启动时，可以使用 `@warp_adopt` tmux 选项采用现有的 Harp 标签。
可自定义设置	所有额外的 UI 部分默认关闭。你可以在 `~/.harp/settings.toml` 中启用它们；更改会自动重新加载。
与 Warp 相同的 AI 后端	Harp 不运行自己的服务器。所有 AI 调用（Claude Code、Codex、Warp Drive、会话共享）都像上游应用一样发送到 Warp 的官方后端。

安装与更新

二进制发行版 – 从 GitHub Releases 页面下载最新的 Harp-<version>.dmg 并拖入 /Applications。Harp 使用自己的包标识符（com.dominikmartn.Harp）并将设置存储在 ~/.harp 下，因此可以与常规 Warp 安装共存。
自动更新 – Harp 每 10 分钟轮询一次 GitHub releases 页面。如果发现新版本，它会下载 DMG、验证签名，并提示你重启进入新版本。
从源码构建 – 需要 macOS 和 Rust 工具链（在 rust-toolchain.toml 中指定）。
```
./script/bootstrap   # 安装工具链和依赖
./script/run        # 构建 Harp.app 并启动它
```
script/macos/run 辅助程序使用找到的第一个“Apple Development”身份对应用进行签名，如果没有，则回退到 ad-hoc 签名。

配置（settings.toml）

[integrations.limit_rings]
enabled = true          # 显示使用限额环
file = "~/.cache/limit-rings.json"  # 数字的 JSON 源

[integrations.tmux]
enabled = true          # 与 tmux 同步组、顺序、标志
session_script = ""    # 用于重命名/重新分组的外部脚本（可选）

其他切换选项允许你缩小标签菜单、恢复上游 CLI 代理工具栏等。更改文件会触发自动重新加载。

谁适合使用？

依赖 AI 编码助手（Claude Code、Codex）的开发人员，需要快速视觉提示哪个助手仍在处理、等待输入或已完成。
tmux 高级用户，希望 AI 驱动的终端标签在 SSH 会话中持续存在并在移动设备上可见。
喜欢 Warp 性能但更喜欢垂直布局的人，当许多 AI 会话打开时，垂直布局扩展性更好。

许可证

代码以 GNU AGPL-3.0（与 Warp 相同）发布，少数 UI crate（warpui、warpui_core）以 MIT 许可证发布。如果你通过网络为他人提供修改版本，AGPL 要求你提供源代码。

快速入门清单

安装 DMG 或从源码构建。
打开 Harp，登录（与 Warp 相同的凭据）。
在 ~/.harp/settings.toml 中启用你想要的侧边栏功能。
（可选）开启 tmux 集成以保持组同步。
打开 Claude Code 或 Codex 会话——观察侧边栏自动更新。

Harp 是 Warp 的非官方分支，与 Warp 公司无关。所有错误报告应提交到此仓库，而不是 Warp 的问题跟踪器。