HKUDS /OpenHarness
"OpenHarness: Open Agent Harness with a Built-in Personal Agent--Ohmo!"
★ 16,212⑂ 2,613👁 89⑃ 204● 158▤ 4
+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
#352[Bug]: send_tool_hints=False 时 bridge 层仍写 INFO 日志(配置未贯穿)2 comments · 2026-08-27#292[Bug]: skills没法执行2 comments · 2026-06-05#18[Discussion] Run-level evidence layer: structured archive for agent runs2 comments · 2026-04-04#302# [BUG] `_record_tool_carryover()` 中 `int()` 无法处理浮点数字符串如 `'250.0'`1 comments · 2026-06-12#298[Bug]: ConfigTool silently stores raw strings for list/dict/nested settings fields1 comments · 2026-06-05#215[Feature]: OHMO是否有支持多租户的计划1 comments · 2026-04-29#47[Feature]: Cursor Agent CLI support1 comments · 2026-04-06#365Parallel teammates share one API key with no prompt caching and no concurrency cap, multiplying token cost0 comments · 2026-10-12
Latest release
v0.1.9 — Skill Workflows and Provider Key Updates v0.1.9 2026-05-07v0.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