harnss  by OpenSource03

Desktop UI for concurrent AI coding agents

Created 3 months ago
269 stars

Top 95.3% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

Harnss is a cross-platform desktop application unifying multiple AI coding agents (Claude Code, Codex, ACP-compatible) into a single interface. It targets developers seeking to streamline workflows by eliminating context switching, providing rich visualizations of AI actions, and offering integrated development tools, thereby enhancing productivity and operational transparency.

How It Works

The application enables concurrent execution of diverse AI agents, preserving context and session state. It utilizes the Agent Client Protocol (ACP) for broad compatibility and features interactive "cards" for tool calls, displaying file edits with syntax highlighting and inline bash output. Integrated workspace tools like a terminal, browser, and Git client, all scoped per project, enhance its utility by centralizing development tasks and offering transparent visualization beyond raw JSON.

Quick Start & Requirements

Pre-built binaries are available for macOS, Windows, and Linux from the Releases page. Development requires cloning the repo and running pnpm install followed by pnpm dev. Engine requirements include an Anthropic account/API key for Claude Code, a Codex CLI and OpenAI API key/account for Codex, and agent-specific configurations for ACP agents. Note that pre-built binaries are unsigned and may trigger OS security warnings.

Highlighted Details

  • Multi-engine Sessions: Run Claude Code, Codex, and ACP agents in parallel, each with independent state.
  • Rich Tool Visualization: Interactive cards display file diffs, inline bash output, and nested subagent progress.
  • Integrated Workspace: Includes a multi-tab terminal, embedded browser, and Git client, all project-scoped.
  • Agent Store & Management: Browse and install ACP agents from a community registry or configure custom agents.
  • Plan Mode & Permissions: Draft execution plans and control agent autonomy with granular permission levels.
  • Image Annotation & Voice Input: Attach/annotate images; utilize native macOS dictation or on-device Whisper for voice input.

Maintenance & Community

The project is in "early development," with users encouraged to report bugs. No specific details regarding maintainers, community channels, or a public roadmap were provided in the README.

Licensing & Compatibility

Harnss is released under the MIT license, which is highly permissive and generally compatible with commercial use.

Limitations & Caveats

As an early-stage project, users should expect potential issues. Pre-built binaries are unsigned, requiring manual user intervention to bypass OS security prompts during installation. Some ACP agent integrations may be experimental.

Health Check
Last Commit

2 days ago

Responsiveness

Inactive

Pull Requests (30d)
3
Issues (30d)
2
Star History
62 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.