Repolode
Submit
dominikmartn

dominikmartn/harp

A macOS fork of the Warp terminal that replaces its tab bar with a sidebar showing which Claude Code or Codex agent needs your attention.

View on GitHub
Stars
317
Forks
18
Open issues
2
Last commit
12 hours ago

What is it?

Harp is an unofficial fork of the open-source Warp terminal aimed at developers who run several long-running coding agents at once. It swaps Warp's tab bar for a sidebar where each session shows whether its Claude Code or Codex agent is working, waiting for input, or done, with an unread mark until you open it.

Tabs can be placed into named groups. When the tmux integration is enabled, group names and order are stored on the tmux sessions, so they persist across restarts and are visible to other tmux clients. Sessions started elsewhere, such as over ssh, can be pulled into the sidebar.

Optional extras include usage-limit rings for the 5-hour and weekly windows, read from a local JSON file that another tool keeps updated. Everything else is upstream Warp, including its AI and cloud features, which connect to Warp's servers as before. Harp is built for macOS and is licensed under AGPL-3.0.

Key features

  • 01Sidebar shows whether each Claude Code or Codex session is working, waiting, or done.
  • 02Unread marks stay until you open the tab.
  • 03Tabs can be grouped, and tmux integration stores groups and order on the sessions.
  • 04Usage-limit rings for the 5-hour and weekly windows, read from a local JSON file.
  • 05Renaming tabs with Cmd+R and setting tabs aside as inactive.
  • 06Installs alongside Warp with its own bundle id and settings folder.

Use cases

  • Supervising several Claude Code or Codex agents working on different tasks at the same time.
  • Keeping a tmux-based development setup organized across restarts and remote sessions.
  • Tracking your Claude or Codex usage limits while agents run in the background.

Quick start

  1. 1

    Download the latest Harp DMG from the Releases page and drag it into Applications

  2. 2

    Clone the repository and run the one-time bootstrap script

    ./script/bootstrap
  3. 3

    Build and launch Harp from source

    ./script/run

Things to know

  • Harp runs only on macOS.
  • Licensed under AGPL-3.0, a copyleft license that requires offering source to network users of modified versions.
  • Logging in through Harp is untested.
  • Building from source needs a Rust toolchain and build dependencies.

Topics

#terminal#ai-agents#claude-code#codex#tmux#macos#rust#developer-tools

FAQ

What is harp?
A macOS fork of the Warp terminal that replaces its tab bar with a sidebar showing which Claude Code or Codex agent needs your attention. Harp is an unofficial fork of the open-source Warp terminal aimed at developers who run several long-running coding agents at once. It swaps Warp's tab bar for a sidebar where each session shows whether its Claude Code or Codex agent is working, waiting for input, or done, with an unread mark until you open it.
Is harp free to use? What license does it have?
harp is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is harp still maintained?
Actively maintained. The last commit to harp was on Oct 20, 2026.
What can I use harp for?
Supervising several Claude Code or Codex agents working on different tasks at the same time. Keeping a tmux-based development setup organized across restarts and remote sessions. Tracking your Claude or Codex usage limits while agents run in the background.
How do I install harp?
Download the latest Harp DMG from the Releases page and drag it into Applications Clone the repository and run the one-time bootstrap script: ./script/bootstrap Build and launch Harp from source: ./script/run
Where can I get harp?
The source code and installation instructions are on GitHub: https://github.com/dominikmartn/harp

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects