OpenHarness — Summary

OpenHarness (HKUDS) is a Python-based open-source implementation of an agent harness runtime — providing a complete infrastructure layer (agent loop, toolkit, memory, governance, swarm coordination) as a standalone Python application with CLI binaries (oh, openh, ohmo). Unlike the Claude Code plugins in this batch, OpenHarness IS the agent runtime, not a plugin for an existing one. It ships 43+ tools (file, shell, search, web, MCP), a React+Ink TUI, an autopilot dashboard (React/Vite), a messaging gateway (Feishu/Slack/Telegram/Discord), multi-provider model support (Claude/OpenAI/Codex/Moonshot/GLM/MiniMax/NVIDIA NIM), and a parallel swarm coordination system. The companion application ohmo is a personal agent built on OpenHarness that connects to messaging platforms and works autonomously. Stars: 13,115. Differs from seeds: closest to claude-flow (Archetype 3: MCP-anchored toolserver, hive-mind coordination) but OpenHarness is a standalone Python runtime rather than an npm package wrapping Claude Code. It also resembles kiro (Archetype 5: closed environment with proprietary primitives) but is fully open-source and model-agnostic.

OpenHarness — Overview

Origin

GitHub: https://github.com/HKUDS/OpenHarness
Stars: 13,115
License: MIT
Language: Python (primary), TypeScript (dashboard/TUI)
Version: 0.1.9
Last commit: 2026-05-24
Organization: HKUDS (Hong Kong University)

Philosophy

From README:

"OpenHarness delivers core lightweight agent infrastructure: tool-use, skills, memory, and multi-agent coordination."

"An Agent Harness is the complete infrastructure that wraps around an LLM to make it a functional agent. The model provides intelligence; the harness provides hands, eyes, memory, and safety boundaries."

The harness equation: LLM + Tools + Knowledge + Observation + Action + Permissions = Agent

What Makes This Different

OpenHarness is unique in this batch as an academic/research-originated standalone Python agent runtime. Unlike all other entries (which are Claude Code plugins or methodology docs), this IS the agent execution environment:

• It manages the agent loop, tool execution, context compression
• It ships its own TUI (React+Ink, Python/Textual)
• It ships an autopilot dashboard (React/Vite)
• It ships a messaging gateway (multi-platform)
• It can run as a server on a VPS, separate from the user's machine

Key Design Decisions

1. Provider-agnostic: API-compatible endpoint works with any provider.
2. Auto-compaction: preserves task state across context compression without manual intervention.
3. Swarm coordination: subagent spawning with team registry and background task lifecycle.
4. ohmo as product: the OpenHarness runtime ships a bundled personal agent (ohmo) as a separate application.
5. Dry-run capability: oh --dry-run previews settings, auth, skills, tools without executing.

OpenHarness — Architecture

Distribution

# One-click install (Linux/macOS)
curl -fsSL https://raw.githubusercontent.com/HKUDS/OpenHarness/main/scripts/install.sh | bash

# Or pip
pip install openharness-ai

# Then setup
oh setup   # interactive wizard
oh         # start chatting

CLI Binaries

• oh (Linux/macOS) / openh (Windows PowerShell)
• ohmo — personal agent app

Directory Tree

OpenHarness/
├── src/openharness/        # Core Python harness
├── ohmo/                   # Personal agent application
│   ├── cli.py
│   ├── runtime.py
│   ├── memory.py
│   └── gateway/            # Messaging platform gateway
├── autopilot-dashboard/    # React/Vite web dashboard
├── frontend/
│   └── terminal/           # React/Ink TUI
├── .agents/
│   └── skills/             # Agent skill definitions
├── .claude/
│   └── skills/             # Claude Code plugin surface
├── scripts/
│   ├── install.sh
│   └── install.ps1
├── pyproject.toml          # Python package (openharness-ai v0.1.9)
└── tests/                  # 114 passing tests

Required Runtime

• Python 3.10+
• Node.js (for dashboard/TUI)
• Ollama or cloud provider API key

Provider Support

Claude, OpenAI, GitHub Copilot, Codex, Moonshot (Kimi), GLM (z.ai), MiniMax, NVIDIA NIM, and any compatible endpoint.

OpenHarness — Components

Core Harness Features

CLI (oh) Subcommands

ohmo Subcommands

Skills (.agents/skills/)

Content not fully enumerated; the skill system is compatible with anthropic/skills format and Claude Code plugins.

MCP Support

Full MCP protocol with HTTP transport, auto-reconnect, tool-only server compatibility, and JSON Schema type inference.

Dashboard

• Autopilot dashboard: React + Vite (frontend dashboard)
• TUI: React + Ink (terminal UI with Shift+Enter support, streaming output)

Messaging Gateway

Supports: Feishu, Slack, Telegram, Discord, with file attachments and multimodal messages.

OpenHarness — Uniqueness

differs_from_seeds

Closest to claude-flow (Archetype 3: standalone runtime with swarm coordination and SQLite memory) but claude-flow is an npm package wrapping Claude Code while OpenHarness is a standalone Python runtime that optionally integrates with Claude Code. Also resembles kiro (Archetype 5: complete environment with proprietary primitives) but is fully open-source and model-agnostic. The ohmo personal agent sub-product (messaging gateway, cross-session user modeling) is closest in spirit to Hermes Agent (NousResearch) and may be an intentional port or parallel development of similar ideas.

Most Distinctive Features

1. Standalone Python runtime: the only framework in the batch that is a complete agent execution environment, not a plugin for one.
2. Multi-platform messaging gateway: Feishu/Slack/Telegram/Discord gateway with file attachments — unique in the catalog.
3. Dry-run with three-verdict system: ready/warning/blocked is a novel UX for pre-flight inspection.
4. Academic origin (HKUDS): university research group origin, combined with 13k stars, suggests strong research validation.

Observable Failure Modes

1. Install complexity: Python 3.10+ + Node.js for TUI/dashboard + provider auth — more dependencies than any seed.
2. Not a Claude Code plugin: users expecting a /plugin install path won't find it; must use pip/curl installer.
3. Swarm stability: subprocess-based swarm with serialized permission modals may deadlock on concurrent agent permission requests.
4. ClawTeam integration: listed as "Roadmap" — advanced swarm features are not yet available.