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.
Badge for your README
Markdown
[](/listings/opensource03--harnss)HTML
<a href="/listings/opensource03--harnss"><img src="/api/listings/opensource03--harnss/badge.svg" alt="findsafeskills safety rating" /></a>Install
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)
- > [!CAUTION]
- > 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.
- > [!WARNING]
- > Harnss is in early development and issues are to be expected. Please feel free to report bugs and issues in the Issues section.
- <p align="center">
- <img alt="harnss_banner" src="https://github.com/user-attachments/assets/88f4dce1-c12b-493a-be8c-a3c418293ef4" />
- </p>
- <p align="center">
- <strong>Harness your AI coding agents.</strong>
- </p>
- <p align="center">
- <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>
- <a href="https://github.com/OpenSource03/harnss/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/OpenSource03/harnss?style=flat-square" /></a>
- <img alt="Platform" src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-brightgreen?style=flat-square" />
- <img alt="Electron" src="https://img.shields.io/badge/electron-40-47848F?style=flat-square&logo=electron&logoColor=white" />
- <img alt="License" src="https://img.shields.io/github/license/OpenSource03/harnss?style=flat-square" />
- <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>
- </p>
- ---
- 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.
- **Why Harnss?**
- - **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.
- - **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.
- - **Your workspace, your way.** Built-in terminal, browser, git, MCP servers, and file panels — all scoped per project, all staying open while you work.
- ---
- ## Screenshots
- <p align="center">
- <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" />
- <br />
- <em>Terminal, browser, git, and MCP integrations — all in one window.</em>
- </p>
- <p align="center">
- <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" />
- <br />
- <em>One UI - all agents. Browse entire ACP registry.</em>
- </p>
- <details>
- <summary>Click to reveal other screenshots</summary>
- https://github.com/user-attachments/assets/41f5bcbc-c141-4a16-b430-79f8e01d107e
- <p align="center">
- <br />
- <em>Organize your projects in spaces.</em>
- </p>
- <p align="center">
- <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" />
- <br />
- <em>Every tool call beautifully visualised - even those from popular MCPs.</em>
- </p>
- <p align="center">
- <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" />
- <br />
- <em>Run multiple agent sessions side by side — switch instantly without losing progress.</em>
- </p>
- </details>
- ---
- ## Features
- ### Multi-engine sessions
- 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.
- ### Rich tool visualization
- 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.
- ### MCP server management
- 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.
- ### Git integration
- 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.
- ### Built-in terminal & browser
- 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.
- ### Project workspaces & spaces
- 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.
- ### Agent Store
- 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.
- ### Plan mode & permission control
- 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.
- ### Background task agents
- 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.
- ### Image attachments & annotation
- 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.
- ### Voice input & notifications
- 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.
- ### Session search & history
- Full-text search across session titles and message content. Import and resume conversations previously started in the Claude Code CLI.
- ---
- ## Quick Start
- 1. **Download** the latest release for your platform from the [Releases page](https://github.com/OpenSource03/harnss/releases/latest)
- 2. **Open a project** — point Harnss at any folder on disk
- 3. **Choose an engine** — Claude Code, Codex, or any installed ACP agent — and start working
- ---
- ## Engines & Agents
- Harnss supports three execution engines out of the box:
- | Engine | Protocol | Requirements |
- |--------|----------|--------------|
- | **Claude Code** | Anthropic Agent SDK | Claude account (subscription or API key) |
- | **Codex** | JSON-RPC app-server | Codex CLI in PATH + OpenAI API key or ChatGPT account |
- | **ACP agents** | Agent Client Protocol | Agent-specific (see registry) |
- 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.
- **Examples of installable ACP-compatible agents:**
- | Agent | Command | Notes |
- |-------|---------|-------|
- | [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `gemini --experimental-acp` | Experimental ACP flag |
- | [Goose](https://github.com/block/goose) | `goose acp` | |
- | [Docker cagent](https://github.com/docker/cagent) | `cagent acp agent.yml` | Container-based agents |
- ### Adding an agent
- 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.
- ---
- ## MCP Servers
- 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.
- ---
- ## Install
- > [!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) |
- ---
- ## Development
- ```bash
- git clone https://github.com/OpenSource03/harnss.git
- cd harnss
- pnpm install
- pnpm dev
- ```
- ### Build installers
- ```bash
- pnpm dist:mac # macOS DMG (arm64 + x64)
- pnpm dist:win # Windows NSIS installer (x64 + ARM64)
- pnpm dist:linux # Linux AppImage + deb
- ```
- ---
- ## Contributing
- 1. Fork the repo and create a feature branch
- 2. Follow the conventions in `CLAUDE.md`
- 3. Test with `pnpm dev`
- 4. Open a pull request
- ---
- ## License
- MIT
- ---
- <p align="center">
- Built on the <a href="https://agentclientprotocol.com">Agent Client Protocol</a>
- </p>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.