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 the virtualenv bin directory to PATH, which avoids clobbering Conda-managed shells.
• React TUI now supports Shift+Enter to insert a newline while keeping plain Enter as submit.
• Busy-state animation in the React TUI is quieter and less error-prone on Windows terminals, with conservative spinner frames and reduced flashing.
• 2026-04-10 🧠 v0.1.6 — Auto-Compaction & Markdown TUI:
• Auto-Compaction preserves task state and channel logs across context compression — agents can run multi-day sessions without manual compact/clear
• Subprocess teammates run in headless worker mode; agent team creation stabilized
• Assistant messages now render full Markdown in the React TUI
• ohmo gains channel slash commands and multimodal attachment support
• 2026-04-08 🔌 v0.1.5 — MCP HTTP transport & Swarm polling:
• MCP protocol adds HTTP transport, auto-reconnect on disconnect, and tool-only server compatibility
• JSON Schema types inferred for MCP tool inputs — no manual type mapping needed
• ohmo channels support file attachments and multimodal gateway messages
• Subprocess agents are now pollable in real runs; permission modals serialized to prevent input swallowing
• 2026-04-08 🌙 v0.1.4 — Multi-provider auth & Moonshot/Kimi:
• Native Moonshot/Kimi provider with reasoning_content support for thinking models
• Auth overhaul: fixed provider-switching key mismatch, OPENAI_BASE_URL env override, profile-scoped credential priority
• MCP gracefully handles disconnected servers in call_tool / read_resource
• Security: built-in sensitive-path protection in PermissionChecker, hardened web_fetch URL validation
• Stability: EIO crash recovery in Ink TUI, --debug logging, Windows cmd flash fix
• 2026-04-06 🚀 v0.1.2 — Unified setup flows and ohmo personal-agent app:
• oh setup now guides provider selection as workflows instead of exposing raw auth/provider internals
• Compatible API setup is now profile-scoped, so Anthropic/OpenAI-compatible endpoints can keep separate keys
• ohmo ships as a packaged app with ~/.ohmo workspace, gateway, bootstrap prompts, and channel config flow
• 2026-04-01 🎨 v0.1.0 — Initial OpenHarness open-source release featuring complete Harness architecture:

Start here: Quick Start · Provider Compatibility · Showcase ·