Repolode
dominikmartn

dominikmartn/harp

基于 Warp 终端的 macOS 分支,用侧边栏替换标签栏,集中显示哪个 Claude Code 或 Codex 智能体需要你处理。

Star
317
Fork
18
未关闭 Issue
2
最近提交
12小时前

这是什么?

Harp 是开源 Warp 终端的非官方分支,面向同时运行多个长时间编码智能体的开发者。它把 Warp 的标签栏换成侧边栏,每个会话都会显示 Claude Code 或 Codex 智能体是在运行、等待输入还是已完成,未查看的会话带有未读标记。

标签可以放入命名分组。开启 tmux 集成后,分组名称和顺序会保存在 tmux 会话上,重启后依然保留,其他 tmux 客户端也能看到相同布局。通过 ssh 等方式在别处启动的会话,也可以被拉入侧边栏。

可选功能包括用量限额圆环,显示 5 小时窗口和每周限额,数据来自另一个工具维护的本地 JSON 文件。其余部分与上游 Warp 相同,包括 AI 与云端功能,仍会连接 Warp 的服务器。Harp 面向 macOS,采用 AGPL-3.0 许可证。

核心功能

  • 01侧边栏显示每个 Claude Code 或 Codex 会话是运行中、等待中还是已完成。
  • 02未查看的会话保留未读标记,直到你打开标签。
  • 03标签可分组,开启 tmux 集成后分组与顺序保存在 tmux 会话上。
  • 04显示 5 小时和每周两个窗口的用量限额圆环,数据读取自本地 JSON 文件。
  • 05按 Cmd+R 重命名标签,也可将标签标记为不活跃。
  • 06与 Warp 并存安装,拥有独立的应用标识和设置目录。

适用场景

  • 同时监督多个在不同任务上工作的 Claude Code 或 Codex 智能体。
  • 在基于 tmux 的开发环境中,跨重启和远程会话保持标签有序。
  • 在智能体后台运行时,查看 Claude 或 Codex 的用量限额。

快速上手

  1. 1

    从 Releases 页面下载最新的 Harp DMG 并拖入“应用程序”文件夹

  2. 2

    克隆仓库并运行一次性的环境准备脚本

    ./script/bootstrap
  3. 3

    从源码构建并启动 Harp

    ./script/run

使用前须知

  • Harp 仅支持 macOS。
  • 采用 AGPL-3.0 许可证,这是一种 copyleft 许可证,修改版若通过网络向他人提供服务,需要公开其源代码。
  • 通过 Harp 登录的功能未经测试。
  • 从源码构建需要 Rust 工具链和构建依赖。

标签

常见问题

harp 是什么?
基于 Warp 终端的 macOS 分支,用侧边栏替换标签栏,集中显示哪个 Claude Code 或 Codex 智能体需要你处理。 Harp 是开源 Warp 终端的非官方分支,面向同时运行多个长时间编码智能体的开发者。它把 Warp 的标签栏换成侧边栏,每个会话都会显示 Claude Code 或 Codex 智能体是在运行、等待输入还是已完成,未查看的会话带有未读标记。
harp 可以免费使用吗?用的什么许可证?
harp 以 AGPL-3.0 许可证开源。用于商业产品前,请先确认许可证条款。
harp 还在维护吗?
活跃维护中。harp 最近一次提交是在 2026年10月20日。
harp 适合用来做什么?
同时监督多个在不同任务上工作的 Claude Code 或 Codex 智能体。 在基于 tmux 的开发环境中,跨重启和远程会话保持标签有序。 在智能体后台运行时,查看 Claude 或 Codex 的用量限额。
harp 怎么安装和运行?
从 Releases 页面下载最新的 Harp DMG 并拖入“应用程序”文件夹 克隆仓库并运行一次性的环境准备脚本: ./script/bootstrap 从源码构建并启动 Harp: ./script/run
在哪里获取 harp?
源代码和安装说明在 GitHub 上:https://github.com/dominikmartn/harp

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目