dominikmartn/harp

The problem

Once you run more than two or three coding agents at once, the terminal stops being a workspace and becomes a queue you cannot read. Tabs carry no state, so you keep cycling through windows to find the one blocked on a permission prompt or a question. Harp, a fork of the open-source Warp terminal, replaces the tab bar with a sidebar whose rows show per-session agent state: working, waiting for you, done, or set aside.

What's different

The usual answer is tmux windows plus discipline, or a terminal multiplexer plugin that shows process names only. Harp's differentiator is that it reads the agent's own session data to derive status, plus two limit rings in the footer: Codex limits from its logs under ~/.codex/sessions, Claude Code limits from the status line, which Harp will add to ~/.claude/settings.json if none exists. Tmux integration is optional and off by default; when enabled, group and ordering are stored on the tmux sessions so they survive restarts and are visible to other tmux clients, including one started from a phone over ssh.

Everything outside the sidebar is upstream Warp, including its AI and cloud features, which still talk to Warp's servers. Harp adds no servers of its own.

Who it's for

Developers already running several Claude Code or Codex sessions per day on macOS, who want a glanceable queue instead of tab archaeology. It is also reasonable for people who like Warp but want a vertical session list. Look elsewhere if you are on Linux or Windows (macOS only), if you deliberately avoid Warp's proprietary account and cloud features, or if you want a lightweight terminal—Harp inherits Warp's whole surface area and its own update channel.

Cost of adoption

macOS only, Rust toolchain from rust-toolchain.toml to build, and an unsigned-by-Apple-notarization path unless you use script/release_macos. The project modifies ~/.claude/settings.json on first launch if you have no status line, which is a side effect worth knowing before you install; a pre-existing status line is left alone and you have to tee the input yourself to get rings. Licensing is AGPL-3.0 (with MIT for the warpui crates), so redistribution has obligations. The README is unusually detailed about settings and internals but thin on test coverage, compatibility with upstream Warp releases, and how status detection behaves when an agent's output format changes.

Verdict

This is a four-day-old fork with 604 stars and roughly +131 stars a day since it appeared—clearly a spike, not an established project. The idea is sound and narrowly scoped: one real pain point, one sidebar, no new servers. But it is one person's fork of a large, fast-moving codebase, macOS-only, and depends on parsing other tools' session files, which is exactly the kind of integration that breaks quietly. Try it if you already live in Warp and juggle agents; give it a month or two before you depend on it for daily work.