by OpenSource03
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.
# Add to your Claude Code skills
git clone https://github.com/OpenSource03/harnss[!WARNING] Harnss is in early development and issues are to be expected. Please feel free to report bugs and issues in the Issues section.
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?
https://github.com/user-attachments/assets/41f5bcbc-c141-4a16-b430-79f8e01d107e
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.
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.
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.
No comments yet. Be the first to share your thoughts!
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.
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.
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.
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.
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.
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.
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 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.
Full-text search across session titles and message content. Import and resume conversations previously started in the Claude Code CLI.
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 inside the app, or configured manually.
Examples of installable ACP-compatible agents:
| Agent | Command | Notes |
|-------|---------|-------|
| Gemini CLI | gemini --experimental-acp | Experimental ACP flag |
| Goose | goose acp | |
| Docker cagent | cagent acp agent.yml | Container-based agents |
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 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.
[!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) |
| macOS (Intel) | .dmg (x64) |
| Windows (x64) | .exe installer |
| Windows (ARM64) | .exe installer |
| Linux | .AppImage / .deb |
git clone https://github.com/OpenSource03/harnss.git
cd harnss
pnpm install
pnpm dev
pnpm dist:mac # macOS DMG (arm64 + x64)
pnpm dist:win # Windows NSIS installer (x64 + ARM64)
pnpm dist:linux # Linux AppImage + deb
CLAUDE.mdpnpm devMIT