# openharness: Manage Coding Agents Across Machines

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/autonomous-ai-openharness
Generated for open source discovery and AI-assisted research.

A desktop command center for running coding agents in tmux across local and remote machines. OpenHarness combines terminal sessions, encrypted connections, worktrees and optional craft-specific harnesses for work beyond software.

GitHub: https://github.com/autonomous-ai/openharness
OSRepos URL: https://osrepos.com/repo/autonomous-ai-openharness

## Summary

A desktop command center for running coding agents in tmux across local and remote machines. OpenHarness combines terminal sessions, encrypted connections, worktrees and optional craft-specific harnesses for work beyond software.

## Topics

- developer-tools
- ai-agents
- coding-agent
- desktop-app
- remote-agent-management
- domain-specific-harnesses

## Repository Information

Last analyzed by OSRepos: Fri Oct 09 2026 21:02:46 GMT+0100 (Western European Summer Time)
Detail views: 0
GitHub clicks: 0

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Overview

OpenHarness is a desktop app and CLI for managing coding-agent sessions across multiple machines. It keeps agents in real tmux terminals, organizes sessions into tabs, and lets you connect machines without manually setting up SSH keys or port forwarding. Its encrypted transport can use direct WebRTC, TURN or a relay.

The project also treats a harness as a way to equip agents for specific disciplines. Its Store includes workflows and viewers for areas such as CAD, electronics, robotics, games and music. This makes it relevant to developers who want one workspace for multiple agents, and to makers who want agents to work with domain-specific tools.

## Key Features

- Run different agent CLIs side by side in separate tmux sessions, without wrapping the agents.
- Manage sessions on a laptop, home server or other linked machine from one app or terminal UI.
- Start agents in separate worktrees to keep the main working copy clean.
- Use end-to-end encrypted remote connections, with direct WebRTC and fallback routes.
- Navigate and split sessions with remappable keyboard shortcuts.
- Install or author domain-specific harnesses that combine instructions, tools, templates, checks and optional viewers.
- Connect the optional open-hardware device over USB to see agent status and respond to prompts.

## Use Cases

- A developer switching between Claude Code, Codex or other supported agent CLIs can keep their sessions organized in one workspace.
- A team member with a laptop and a home or cloud machine can start agents remotely without exposing an inbound machine port.
- A maker working on a circuit, CAD model or robot simulation can use a domain-specific harness and its viewer to give an agent tools suited to that craft.
- A terminal-focused user can manage harnesses across machines with the `hn` interface instead of relying on the desktop app.

## Our Take
OpenHarness is a broad, actively changing agent workspace for users who want persistent terminal sessions and remote machine control, with domain-specific workflows as a distinctive extension.

**Good fit if:**
- You already use CLI-based coding agents and want to manage several sessions across machines.
- tmux-based terminals, worktrees and a keyboard-first workflow suit how you work.
- You want to experiment with agent workflows for CAD, circuits, robotics or other supported disciplines.

**Look elsewhere if:**
- You need a lightweight wrapper for just one local agent rather than a multi-machine command center.
- Your workflow depends on agents that are not among the supported engines or on harnesses unavailable in the Store.
- You do not want to adopt a young, fast-changing project, even though it has recent releases and contributions from multiple contributors.

## Project Health

| Signal | Value |
|---|---|
| Status | **New**: less than six months old and changing fast |
| Last commit | 2026-10-09 (today) |
| Commits, last 90 days | 100+ |
| Releases, last 12 months | 100+ (latest v1.3.42_web, 2026-10-09) |
| Contributors | 28 (top contributor: 61% of commits) |
| Issues closed, last 90 days | 0+ |
| Pull requests merged, last 90 days | 96 (typically merged in 0 days) |
| Project age | 2 months |

Checked on 2026-10-09 with the GitHub API.

## Project Facts

- Language: Dart
- License: MIT
- Stars: 1.2k
- Forks: 100
- Topics: 3d-modeling, agent-framework, agent-harness, ai-agents, cad, claude-code, codex, coding-agents
- Archived: no

## What You Need

Detected in the repository:

- Dart (main language on GitHub)
- A test suite and automated checks on GitHub Actions

## Getting Started
Download the macOS or Linux app from the [project site](https://harness.autonomous.ai/desktop). To add a machine, install the CLI and start its daemon:

```bash
curl -fsSL https://harness.autonomous.ai/cli/install.sh | bash
harness login
harness remote-password set
harness start
```

Then link the machine in the app. See the [README](https://github.com/autonomous-ai/openharness) for terminal use, source builds and configuration details.

## License in Plain Words

**MIT** (permissive).

- Commercial use: yes
- Modify and redistribute: yes
- You must keep: the copyright and license notice
- Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

## Alternatives

- [vicoa](https://osrepos.com/repo/vicoa-ai-vicoa): Vicoa adds task management and review tools across desktop, web, mobile, and CLI, while OpenHarness centers on tmux sessions and optional craft-specific harnesses.
- [orca](https://osrepos.com/repo/stablyai-orca): Orca focuses on coordinating and reviewing agents in isolated Git worktrees; OpenHarness centers on tmux sessions and encrypted local or remote connections.
- [claude-code-by-agents](https://osrepos.com/repo/baryhuang-agentrooms): Claude Code by Agents organizes work in threaded rooms with @mentions, while OpenHarness uses tmux sessions and supports craft-specific harnesses.
- [synara](https://osrepos.com/repo/emanuele-web04-synara): Synara brings project files, previews, and Git review into a local workspace; OpenHarness emphasizes tmux and encrypted connections to remote machines.

| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| **openharness** | Dart | MIT | 1.2k | New |
| [vicoa](https://osrepos.com/repo/vicoa-ai-vicoa) | Python | AGPL-3.0 | 471 | New |
| [orca](https://osrepos.com/repo/stablyai-orca) | TypeScript | MIT | 84.4k | Active |
| [claude-code-by-agents](https://osrepos.com/repo/baryhuang-agentrooms) | Swift | MIT | 892 | Quiet |
| [synara](https://osrepos.com/repo/emanuele-web04-synara) | TypeScript | MIT | 2k | Active |

## Considerations

OpenHarness is new and changing quickly. Repository activity and releases are recent, with contributions from many people and no strong dependence on a single contributor, but the project's short history means its long-term stability is not yet established. The supplied health data does not provide a useful issue-resolution time, so it is difficult to assess how quickly reported problems are closed.

The desktop app is available for macOS and Linux. Building from source requires Node.js, tmux, Xcode and Flutter/Dart; the README's source-build instructions therefore include platform-specific setup. Remote access also depends on the project's daemon and connection paths, so teams should review its [architecture](https://github.com/autonomous-ai/openharness/blob/main/docs/architecture.md) and [security information](https://github.com/autonomous-ai/openharness/blob/main/SECURITY.md) before relying on it for sensitive work. The repository is MIT-licensed, while bundled upstream tools retain their own licenses.