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
下载:v0.1.9 — Skill Workflows and Provider Key Updatesv0.1.9 ↓0.1.92026-05-07
+2
日增长
16,212
stars
2,613
forks
89
watchers
204
prs
158
issues
4
releases

README

oh — OpenHarness 中文说明


  English ·
  简体中文


OpenHarness 是一个面向开源社区的 Agent Harness。它提供轻量、可扩展、可检查的 Agent 基础设施,包括:

- Agent loop
- tools / skills / plugins
- memory / session resume
- permissions / hooks
- multi-agent coordination
- provider workflows
- React TUI
- ohmo personal-agent app

---

 最新更新

 Unreleased · Dry-run 安全预览

- 新增 oh --dry-run,可以在不执行模型、不执行工具、不 spawn subagent 的前提下,预览当前会话会使用的配置、skills、commands、tools 和 MCP 配置。
- Dry-run 会给出 ready / warning / blocked 结论,并直接告诉你下一步该做什么,例如先修认证、先修 MCP 配置,或者可以直接运行。
- 对普通 prompt,会给出可能命中的 skills / tools;对 slash command,会展示它更偏只读还是会改本地状态。

 2026-04-06 · v0.1.2

- 新增统一配置入口 oh setup
- provider 配置从“auth - provider - model”收敛成 workflow 视角
- Anthropic/OpenAI 兼容接口支持 profile 级凭据,不再强制共用一把全局 key
- 新增 ohmo personal-agent app
- ohmo 使用 ~/.ohmo 作为 home workspace,支持 gateway、bootstrap prompts 和交互式 channel 配置

---

 快速开始

 一键安装

bash
curl -fsSL https://raw.githubusercontent.com/HKUDS/OpenHarness/main/scripts/install.sh | bash


常用安装参数:

- --from-source:从源码安装,适合贡献者
- --with-channels:一并安装 IM channel 依赖

例如:

bash
curl -fsSL https://raw.githubusercontent.com/HKUDS/OpenHarness/main/scripts/install.sh | bash -s -- --from-source --with-channels


 本地运行

bash
git clone https://github.com/HKUDS/OpenHarness.git
cd OpenHarness
uv sync --extra dev
uv run oh


---

 配置模型与 Provider

现在最推荐的入口是:

bash
oh setup


oh setup 会按下面的顺序引导:

1. 选择一个 workflow
2. 如果需要,完成认证
3. 选择具体后端 preset
4. 确认模型
5. 保存并激活 profile

当前内置 workflow 包括:

- Anthropic-Compatible API
- Claude Subscription
- OpenAI-Compatible API
- Codex Subscription
- GitHub Copilot

 Anthropic-Compatible API

适合这类后端:

- Claude 官方 API
- Moonshot / Kimi
- Zhipu / GLM
- MiniMax
- 其他 Anthropic-compatible endpoint

 OpenAI-Compatible API

适合这类后端:

- OpenAI 官方 API
- OpenRouter
- DashScope
- DeepSeek
- GitHub Models
- SiliconFlow
- Google Gemini
- Groq
- Ollama
- 其他 OpenAI-compatible endpoint

 常用命令

bash
 统一配置入口
oh setup

 查看已有 workflow/profile
oh provider list

 切换当前 workflow
oh provider use codex

 查看认证状态
oh auth status


 高级:添加自定义兼容接口

如果内置 preset 不够,可以直接新增 profile:

bash
oh provider add my-endpoint \
  --label "My Endpoint" \
  --provider anthropic \
  --api-format anthropic \
  --auth-source anthropic_api_key \
  --model my-model \
  --base-url https://example.com/anthropic


这一版开始,兼容接口可以按 profile 绑定凭据。  
也就是说,Kimi、GLM、MiniMax 这类 Anthropic-compatible 后端,不需要再共用一把全局 anthropic key。

---

 交互模式与 TUI

运行:

bash
oh


你会得到 React/Ink TUI,支持:

- / 命令选择器
- 交互式权限确认
- /model 模型切换
- /permissions 权限模式切换
- /resume 会话恢复
- /provider workflow 选择

非交互模式也支持:

bash
oh -p "Explain this repository"
oh -p "List all functions in main.py" --output-format json
oh -p "Fix the bug" --output-format stream-json


 Dry-run 安全预览

如果你想先看 OpenHarness 会怎么跑,但又不想真的执行模型或工具,可以用:

bash
 预览交互会话本身
oh --dry-run

 预览一个普通 prompt
oh --dry-run -p "Review this bug fix and grep for failing tests"

 预览 slash command
oh --dry-run -p "/plugin list"

 输出结构化 JSON,方便脚本或 channel 使用
oh --dry-run -p "Explain this repository" --output-format json

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