HKUDS /OpenHarness

"OpenHarness: Open Agent Harness with a Built-in Personal Agent--Ohmo!"

★ 16,212⑂ 2,613👁 89⑃ 204● 158▤ 4
PythonMITCreated 2026-04-01
Download: v0.1.9 — Skill Workflows and Provider Key Updatesv0.1.9 ↓0.1.92026-05-07
+2
Daily
16,212
stars
2,613
forks
89
watchers
204
prs
158
issues
4
releases

README

  
  
  
  oh — OpenHarness & ohmo



  English ·
  简体中文


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

ohmo is a personal AI agent built on OpenHarness — not another chatbot, but an assistant that actually works for you over long sessions. Chat with ohmo in Feishu / Slack / Telegram / Discord, and it forks branches, writes code, runs tests, and opens PRs on its own. ohmo runs on your existing Claude Code or Codex subscription — no extra API key needed.

Join the community: contribute Harness for open agent development.


  
  
  
  
  



  
  
  
  
  
  
  
  


One Command (oh) to Launch OpenHarness and Unlock All Agent Harnesses. 

Supports CLI agent integration including OpenClaw, nanobot, Cursor, and more.


  


---
 ✨ OpenHarness's Key Harness Features





🔄 Agent Loop


  




• Streaming Tool-Call Cycle
• API Retry with Exponential Backoff
• Parallel Tool Execution
• Token Counting & Cost Tracking




🔧 Harness Toolkit


  




• 43 Tools (File, Shell, Search, Web, MCP)
• On-Demand Skill Loading (.md)
• Plugin Ecosystem (Skills + Hooks + Agents)
• Compatible with anthropics/skills & plugins




🧠 Context & Memory


  




• CLAUDE.md Discovery & Injection
• Context Compression (Auto-Compact)
• MEMORY.md Persistent Memory
• Session Resume & History




🛡️ Governance


  




• Multi-Level Permission Modes
• Path-Level & Command Rules
• PreToolUse / PostToolUse Hooks
• Interactive Approval Dialogs




🤝 Swarm Coordination


  




• Subagent Spawning & Delegation
• Team Registry & Task Management
• Background Task Lifecycle
• ClawTeam Integration (Roadmap)





---

 🤔 What is an Agent Harness?

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.


  


OpenHarness is an open-source Python implementation designed for researchers, builders, and the community:

- Understand how production AI agents work under the hood
- Experiment with cutting-edge tools, skills, and agent coordination patterns
- Extend the harness with custom plugins, providers, and domain knowledge
- Build specialized agents on top of proven architecture

---

 📰 What's New

- Unreleased 🔍 Dry-run safe preview:
  - oh --dry-run previews resolved runtime settings, auth state, skills, commands, tools, and configured MCP servers without executing the model, tools, or subagents.
  - Dry-run now reports a ready / warning / blocked readiness verdict with concrete next-step suggestions such as fixing auth, fixing MCP config, or running the prompt directly.
  - Prompt previews include likely matching skills and tools, while slash-command previews show whether the command is mostly read-only or stateful.
- 2026-04-18 ⚙️ v0.1.7 — Packaging & TUI polish:
  - Install script now links oh, ohmo, and openharness into ~/.local/bin instead of prepending t

Top issues

Latest release

v0.1.9 — Skill Workflows and Provider Key Updates v0.1.9 2026-05-07
v0.1.9 — Skill Workflows and Provider Key Updates

OpenHarness v0.1.9 is a small follow-up release after v0.1.8 focused on making skills easier to create and invoke, plus fixing provider API key updates.

 Highlights

- Bundled skill creator
  - Added a bundled skill-creator skill for creating, improving, and verifying OpenHarness/ohmo skills.
  - This makes repeatable workflows easier to capture as first-class skills.

- User-invocable skill slash commands
  - Skills marked as user-invocable can now be triggered directly with slash commands.
  - Slash-invoked skills support user arguments and

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON