dominikmartn/harp

选用指南

AI 根据 README 整理 · 2026/10/20 22:41:42

适用场景

适合需要同时运行多个 Claude Code 或 Codex 编码代理的开发者，通过侧边栏快速查看哪些代理需要关注，并支持分组和 tmux 同步。

查看 README 依据

<p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="images/hero-dark.png"> <img src="images/hero-light.png" width="800" alt="Harp: the app icon and name above a Harp window with sessions grouped in the sidebar and a Claude Code session at work, with agents working, waiting for you, done and set aside"> </picture> </p> <p align="center"> Run many Claude Code and Codex agents side by side, in one calm sidebar that tells you which one needs you. </p> <p align="center">

done, with an unread mark until you look. A dot means background work is still running; a moon marks a tab you set aside. Cmd+R renames a tab.</p> <h3>Groups that stay put</h3> <p>Put tabs into named groups. With the tmux integration on, the group and the order are stored on the tmux sessions, so they survive a restart and other tmux clients see the same layout.</p> </td> </tr> <tr> <td width="50%" valign="top"> <picture> <source media="(prefers-color-scheme: dark)" srcset="images/limit-rings-dark.png">

目标用户

面向使用 Claude Code 和 Codex 代理的开发者，特别是需要管理多个长时运行代理的用户。

查看 README 依据

<p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="images/hero-dark.png"> <img src="images/hero-light.png" width="800" alt="Harp: the app icon and name above a Harp window with sessions grouped in the sidebar and a Claude Code session at work, with agents working, waiting for you, done and set aside"> </picture> </p> <p align="center"> Run many Claude Code and Codex agents side by side, in one calm sidebar that tells you which one needs you. </p> <p align="center">

使用方式

通过下载 DMG 安装到 Applications，或从源码构建（需要 macOS 和 Rust 工具链）。额外功能默认关闭，需在 ~/.harp/settings.toml 中启用。

查看 README 依据

**Download:** grab the latest `Harp-<version>.dmg` from [Releases](../../releases/latest) and drag Harp into Applications. Harp has its own bundle id (`com.dominikmartn.Harp`), URL scheme (`harp://`) and settings folder (`~/.harp`), so it runs next to Warp without sharing anything. **Build from source** (macOS, Rust toolchain from `rust-toolchain.toml`): ```sh ./script/bootstrap # one-time: toolchain and build dependencies ./script/run # builds target/debug/bundle/osx/Harp.app and launches it ```

`script/macos/run` signs with the first "Apple Development" identity in your keychain and falls back to an ad-hoc signature. A signed, notarizable release DMG comes from `script/release_macos` (see `--help`). ## Settings The extras are off by default. Turn them on in `~/.harp/settings.toml`; the app reloads the file when it changes. ```toml [integrations.limit_rings] enabled = true file = "~/.cache/limit-rings.json" [integrations.tmux] enabled = true ``` | Setting | Default | Effect | |---|---|---|

部署要求

需要 macOS 系统；从源码构建需要 Rust 工具链。

查看 README 依据

<a href="LICENSE-AGPL"><img alt="License: AGPL-3.0" src="https://img.shields.io/badge/license-AGPL--3.0-blue"></a> <img alt="Platform: macOS" src="https://img.shields.io/badge/platform-macOS-lightgrey"> </p> Harp is an unofficial fork of the open-source [Warp](https://github.com/warpdotdev/warp) terminal. It replaces the tab bar with a sidebar built for long-running coding agents and keeps the rest of Warp as it is. ## What it adds <table> <tr> <td width="50%" valign="top"> <picture> <source media="(prefers-color-scheme: dark)" srcset="images/sidebar-dark.png">

**Download:** grab the latest `Harp-<version>.dmg` from [Releases](../../releases/latest) and drag Harp into Applications. Harp has its own bundle id (`com.dominikmartn.Harp`), URL scheme (`harp://`) and settings folder (`~/.harp`), so it runs next to Warp without sharing anything. **Build from source** (macOS, Rust toolchain from `rust-toolchain.toml`): ```sh ./script/bootstrap # one-time: toolchain and build dependencies ./script/run # builds target/debug/bundle/osx/Harp.app and launches it ```

已知限制

Harp 是 Warp 的非官方分支，登录功能未经测试；侧边栏布局中移除了标签栏的搜索字段、视图选项和标签配置按钮。

查看 README 依据

<p>Tabs attached to tmux follow their session: name, group, read and inactive flags. A session started elsewhere, for example from your phone over ssh, can ask for a tab with <code>tmux set-option @warp_adopt 1</code>.</p> </td> </tr> </table> Everything else is upstream Warp, including its AI and cloud features (agents, Warp Drive, session sharing, login). They talk to Warp's servers exactly as upstream does; Harp adds no servers of its own. Logging in through Harp is untested. ## Install

**Removed on purpose:** the tab bar's search field, view options and tab-config buttons in the sidebar layout (new tabs come from Cmd+T, a double-click or the right-click menu on empty sidebar space), the sidebar divider option and the title-strip panel toggles. **Development switches** (environment, at launch): `WARPOSS_STATUS_TRACE=1` logs every change of a row's shown status to `~/Library/Logs/harp.log` as a `[status-check]` line, for regression checks against an agent's transcript. `WARPOSS_SKIP_LOGIN=1` starts with a test user and fails every