harp

Settings

Limit rings

The rings are on by default and show the agents you use:

• Codex: read from the rate_limits Codex logs into ~/.codex/sessions (or $CODEX_HOME). They appear once Codex has answered at least once.
• Claude Code: Claude Code hands its plan limits only to its status line. On first start, if ~/.claude/settings.json has no statusLine yet, Harp adds one that saves the status line's input to ~/.harp/claude-statusline.json and prints nothing. A status line you already have is left alone; to keep yours and get the rings, save the input first, for example "command": "tee ~/.harp/claude-statusline.json | your-command". The rings appear after Claude Code's next answer, for Claude.ai plans (not API keys).

More providers can come from a JSON file another tool keeps current (format); its entries replace Harp's own readings of the same name.

Other extras

The other extras are off by default. Turn them on in ~/.harp/settings.toml; the app reloads the file when it changes.

[integrations.limit_rings]
enabled = true
file = "~/.cache/limit-rings.json"

[integrations.tmux]
enabled = true

Claude Code status needs no setup. Harp ships its own Claude Code plugin (based on Warp's, MIT) in Harp.app/Contents/Resources/bundled/claude-plugin/harp and points every shell it opens at it with CLAUDE_CODE_PLUGIN_DIRS, so each Claude Code started in Harp loads it for that session. Nothing is installed into ~/.claude, and Claude Code in other terminals is not affected. If you also have Warp's plugin installed, Harp uses its own plugin's reports and ignores the duplicates. The plugin uses jq, which macOS 15 and later include.

Without a plugin (Codex, a Claude Code older than 2.1.280, or one started outside a Harp shell) the row still shows working and done, read from the spinner the agent puts in its own terminal title; "needs you" and the background dot need Claude Code's plugin. An agent that reports nothing at all, such as one in a tmux server that was running before Harp, says "Restart the agent here for status" in the card header.

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 authenticated request, for automated runs without a login. WARP_DATA_PROFILE=<name> (debug builds) keeps settings and data in ~/.harp-<name>.

Identity: the name comes from app_display_name!() in app/src/lib.rs. Bundle id, URL scheme and settings folder are set in app/Cargo.toml, app/src/bin/oss.rs, crates/warp_core/src/channel/state.rs, crates/warp_core/src/paths.rs, script/macos/bundle, script/macos/run, crates/warpui/src/browser.rs, app/channels/oss/com.dominikmartn.Harp.desktop and flake.nix. Internal names stay Warp's: the warp-oss binary, the crates, the WARPOSS_* switches and the @warp_* tmux options other tmux clients read.

Run ./script/presubmit (format, clippy, tests) before sending changes.

Based on Warp

Harp is an unofficial fork of warpdotdev/warp and is not made, endorsed or supported by Warp (Denver Technologies, Inc.) or affiliated with them. "Warp" is their name. Please report issues with Harp here, not to Warp.

Credits

• Warp, the terminal Harp is built on, and the open-source projects it depends on (list).
• Sidebar icons from the Hugeicons free set (MIT) and Phosphor (MIT); the licenses are in app/assets/bundled/svg/hugeicons/ and app/assets/bundled/svg/phosphor/.

License

Like upstream, the code is under the GNU AGPL v3, except the warpui and warpui_core crates, which are MIT. If you run a modified version for others over a network, the AGPL asks you to offer them its source.

Made by @dominikmartn · dominikmart.in. Other projects:

• Ocelli · Meeting notes and dictation for your Mac
• hue · Drop a brand link, name or screenshot and it one shots a full design system
• nothing-design-skill · UI in the Nothing design language. Monochrome, typographic, industrial