Skip to content
Back to search

harnss

Open-source, desktop client/UI build to harness Claude Code, Codex and any other Agent accepting Agent Client Protocol. Run multiple AI coding agents side by side with rich tool visualization, MCP integrations, built-in terminal, git, browser and just about anything else you may need.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/opensource03--harnss/badge.svg)](/listings/opensource03--harnss)

HTML

<a href="/listings/opensource03--harnss"><img src="/api/listings/opensource03--harnss/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

> [!NOTE] > Pre-built binaries are currently **unsigned**. On macOS, right-click the app and choose **Open** to bypass the Gatekeeper warning on first launch. On Windows, click **More info → Run anyway** if Windows Defender flags the installer.

| Platform | Download | |----------|----------| | macOS (Apple Silicon) | [`.dmg` (arm64)](https://github.com/OpenSource03/harnss/releases/latest) | | macOS (Intel) | [`.dmg` (x64)](https://github.com/OpenSource03/harnss/releases/latest) | | Windows (x64) | [`.exe` installer](https://github.com/OpenSource03/harnss/releases/latest) | | Windows (ARM64) | [`.exe` installer](https://github.com/OpenSource03/harnss/releases/latest) | | Linux | [`.AppImage`](https://github.com/OpenSource03/harnss/releases/latest) / [`.deb`](https://github.com/OpenSource03/harnss/releases/latest) |

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 228 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. > [!CAUTION]
  2. > Harnss is currently pending a large rewrite to improve usability, performance and overall codebase into a more production ready app. I will share more info about it soon.
  3. > [!WARNING]
  4. > Harnss is in early development and issues are to be expected. Please feel free to report bugs and issues in the Issues section.
  5. <p align="center">
  6. <img alt="harnss_banner" src="https://github.com/user-attachments/assets/88f4dce1-c12b-493a-be8c-a3c418293ef4" />
  7. </p>
  8. <p align="center">
  9. <strong>Harness your AI coding agents.</strong>
  10. </p>
  11. <p align="center">
  12. <a href="https://github.com/OpenSource03/harnss/releases"><img alt="Latest Release" src="https://img.shields.io/github/v/release/OpenSource03/harnss?style=flat-square&color=blue" /></a>
  13. <a href="https://github.com/OpenSource03/harnss/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/OpenSource03/harnss?style=flat-square" /></a>
  14. <img alt="Platform" src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-brightgreen?style=flat-square" />
  15. <img alt="Electron" src="https://img.shields.io/badge/electron-40-47848F?style=flat-square&logo=electron&logoColor=white" />
  16. <img alt="License" src="https://img.shields.io/github/license/OpenSource03/harnss?style=flat-square" />
  17. <a href="https://github.com/OpenSource03/harnss/actions"><img alt="Build" src="https://img.shields.io/github/actions/workflow/status/OpenSource03/harnss/build.yml?style=flat-square&label=build" /></a>
  18. </p>
  19. ---
  20. Harnss is a cross-platform desktop app that gives you one interface to run, manage, and switch between AI coding agents — Claude Code, Codex, and any ACP-compatible agent — without losing context, sessions, or tool state.
  21. **Why Harnss?**
  22. - **One app, every agent.** Run Claude Code, Codex, and custom ACP agents side by side. No more juggling terminals or losing context when switching tools.
  23. - **See what your AI is actually doing.** Tool calls render as interactive cards with word-level diffs, syntax highlighting, and inline bash output — not raw JSON.
  24. - **Your workspace, your way.** Built-in terminal, browser, git, MCP servers, and file panels — all scoped per project, all staying open while you work.
  25. ---
  26. ## Screenshots
  27. <p align="center">
  28. <img width="2069" height="1333" alt="CleanShot 2026-03-08 at 05 39 16" src="https://github.com/user-attachments/assets/87f06ec9-e09d-4889-9aa0-6904eb68f30a" />
  29. <br />
  30. <em>Terminal, browser, git, and MCP integrations — all in one window.</em>
  31. </p>
  32. <p align="center">
  33. <img width="2069" height="1333" alt="CleanShot 2026-03-08 at 05 40 20" src="https://github.com/user-attachments/assets/7dc6b42f-398b-405e-9413-7192b2aaecb6" />
  34. <br />
  35. <em>One UI - all agents. Browse entire ACP registry.</em>
  36. </p>
  37. <details>
  38. <summary>Click to reveal other screenshots</summary>
  39. https://github.com/user-attachments/assets/41f5bcbc-c141-4a16-b430-79f8e01d107e
  40. <p align="center">
  41. <br />
  42. <em>Organize your projects in spaces.</em>
  43. </p>
  44. <p align="center">
  45. <img width="825" height="721" alt="CleanShot 2026-03-02 at 02 43 43" src="https://github.com/user-attachments/assets/842c29f8-c11a-4a26-9940-380c4f4cb6a2" />
  46. <br />
  47. <em>Every tool call beautifully visualised - even those from popular MCPs.</em>
  48. </p>
  49. <p align="center">
  50. <img width="251" height="198" alt="CleanShot 2026-03-02 at 02 33 04" src="https://github.com/user-attachments/assets/f1c8930f-16fb-4d3f-8d2e-330425965291" />
  51. <br />
  52. <em>Run multiple agent sessions side by side — switch instantly without losing progress.</em>
  53. </p>
  54. </details>
  55. ---
  56. ## Features
  57. ### Multi-engine sessions
  58. Run Claude Code (via the Anthropic SDK), Codex, and ACP-compatible agents in parallel. Each session has its own state, history, and context. Switch between them instantly.
  59. ### Rich tool visualization
  60. Every tool call renders as an interactive card. File edits show word-level diffs with syntax highlighting. Bash output appears inline. Subagent tasks nest with step-by-step progress tracking. File changes are summarized per turn with a dedicated Changes panel.
  61. ### MCP server management
  62. Connect any MCP server per project via stdio, SSE, or HTTP transport. OAuth flows are handled automatically. Server status and available tool counts are visible at a glance. Jira, Confluence, and other integrations render with dedicated UIs rather than raw JSON.
  63. ### Git integration
  64. Stage, unstage, commit, and push without leaving the app. Browse branches, view commit history, and manage git worktrees. AI-generated commit messages are available from the staged diff.
  65. ### Built-in terminal & browser
  66. Multi-tab PTY terminal backed by native shell processes. An embedded browser for opening URLs inline and providing additional context to the agent. Both panels stay mounted while you work.
  67. ### Project workspaces & spaces
  68. Projects map to folders on disk. Spaces let you organize projects into named groups with custom icons and colors. Sessions, history, and panel settings are all scoped per project.
  69. ### Agent Store
  70. Browse and install agents from the ACP community registry directly in the app. Add custom agents by specifying a command, arguments, environment variables, and an icon. All configuration is managed through Settings — no config files.
  71. ### Plan mode & permission control
  72. Work in plan mode to have the agent draft a plan before making any changes. Three permission levels — Ask First, Accept Edits, Allow All — control how much autonomy the agent has. Switch modes at any point without interrupting context.
  73. ### Background task agents
  74. Task agents spawned during a session continue running in the background and are tracked in a dedicated panel. Keep working in other sessions while long-running tasks complete.
  75. ### Image attachments & annotation
  76. Attach screenshots or images directly in the chat. An built-in annotation tool lets you draw, highlight, and mark up images with freehand strokes before sending them to the agent.
  77. ### Voice input & notifications
  78. Voice input via native macOS dictation or an on-device Whisper model (no API key required). Configurable OS notifications for plan approval requests, permission prompts, agent questions, and session completion.
  79. ### Session search & history
  80. Full-text search across session titles and message content. Import and resume conversations previously started in the Claude Code CLI.
  81. ---
  82. ## Quick Start
  83. 1. **Download** the latest release for your platform from the [Releases page](https://github.com/OpenSource03/harnss/releases/latest)
  84. 2. **Open a project** — point Harnss at any folder on disk
  85. 3. **Choose an engine** — Claude Code, Codex, or any installed ACP agent — and start working
  86. ---
  87. ## Engines & Agents
  88. Harnss supports three execution engines out of the box:
  89. | Engine | Protocol | Requirements |
  90. |--------|----------|--------------|
  91. | **Claude Code** | Anthropic Agent SDK | Claude account (subscription or API key) |
  92. | **Codex** | JSON-RPC app-server | Codex CLI in PATH + OpenAI API key or ChatGPT account |
  93. | **ACP agents** | Agent Client Protocol | Agent-specific (see registry) |
  94. Claude Code and Codex are built-in. ACP agents can be installed from the [ACP Agent Registry](https://agentclientprotocol.com/get-started/registry) inside the app, or configured manually.
  95. **Examples of installable ACP-compatible agents:**
  96. | Agent | Command | Notes |
  97. |-------|---------|-------|
  98. | [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `gemini --experimental-acp` | Experimental ACP flag |
  99. | [Goose](https://github.com/block/goose) | `goose acp` | |
  100. | [Docker cagent](https://github.com/docker/cagent) | `cagent acp agent.yml` | Container-based agents |
  101. ### Adding an agent
  102. Open **Settings → ACP Agents**. The **Agent Store** tab lets you browse and install agents from the community registry. The **My Agents** tab lets you create custom agents — set the binary command, arguments, environment variables, and icon, or paste a JSON definition to auto-fill the form.
  103. ---
  104. ## MCP Servers
  105. MCP servers are configured per project through the **MCP Servers panel** in the right-side toolbar. Supported transports: stdio, SSE, and HTTP. OAuth authentication is handled in-app with token persistence across sessions.
  106. ---
  107. ## Install
  108. > [!NOTE]
  109. > Pre-built binaries are currently **unsigned**. On macOS, right-click the app and choose **Open** to bypass the Gatekeeper warning on first launch. On Windows, click **More info → Run anyway** if Windows Defender flags the installer.
  110. | Platform | Download |
  111. |----------|----------|
  112. | macOS (Apple Silicon) | [`.dmg` (arm64)](https://github.com/OpenSource03/harnss/releases/latest) |
  113. | macOS (Intel) | [`.dmg` (x64)](https://github.com/OpenSource03/harnss/releases/latest) |
  114. | Windows (x64) | [`.exe` installer](https://github.com/OpenSource03/harnss/releases/latest) |
  115. | Windows (ARM64) | [`.exe` installer](https://github.com/OpenSource03/harnss/releases/latest) |
  116. | Linux | [`.AppImage`](https://github.com/OpenSource03/harnss/releases/latest) / [`.deb`](https://github.com/OpenSource03/harnss/releases/latest) |
  117. ---
  118. ## Development
  119. ```bash
  120. git clone https://github.com/OpenSource03/harnss.git
  121. cd harnss
  122. pnpm install
  123. pnpm dev
  124. ```
  125. ### Build installers
  126. ```bash
  127. pnpm dist:mac # macOS DMG (arm64 + x64)
  128. pnpm dist:win # Windows NSIS installer (x64 + ARM64)
  129. pnpm dist:linux # Linux AppImage + deb
  130. ```
  131. ---
  132. ## Contributing
  133. 1. Fork the repo and create a feature branch
  134. 2. Follow the conventions in `CLAUDE.md`
  135. 3. Test with `pnpm dev`
  136. 4. Open a pull request
  137. ---
  138. ## License
  139. MIT
  140. ---
  141. <p align="center">
  142. Built on the <a href="https://agentclientprotocol.com">Agent Client Protocol</a>
  143. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.