Openharness

io.github.philo-kim由 GitHub 账号 philo-kim 发布v0.1.1更新于 Oct 24, 2026

Lets AI coding agents discover and reference each other's recent sessions.

已验证STDIO仅桌面知识与记忆开发者工具

概览

AI 生成的概览

一个本地 MCP 服务器，让 AI 编程代理发现并引用彼此最近的会话文件，从而参考另一个代理的工作。

可以做什么
按项目路径筛选，列出所有受支持代理的最近会话路径与元数据，包括格式、更新时间以及匹配方式（目录名、工作区字段或路径哈希）。查询指定代理最近的一次会话路径，找不到时返回空值。支持的代理为 Claude Code、Codex CLI 和 Gemini CLI。它只提供路径和元数据，由调用方代理自行读取会话文件。
适用场景
适合在同一项目上同时使用多个编程代理，并希望其中一个审阅或延续另一个最近工作的场景，例如让 Codex 审阅 Claude Code 的最新会话。若只使用单一代理，或不希望代理读取彼此的本地会话文件，则无需安装。
运行要求
以本地进程方式运行，通过 npm 包安装，需要 Node.js 和 npm。每个代理必须能直接读取本地文件。安装时需将服务器注册到各代理的配置中，可用 init 命令或手动添加 MCP 配置项。未声明账号、API 密钥或环境变量。
安装前请注意
它会暴露本地会话文件的路径，这些文件可能包含敏感的对话内容；服务器本身不读取、转换或存储内容，但调用方代理会直接读取这些文件。全局安装并运行 init 命令会修改各代理的 MCP 配置文件。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Openharness，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

OpenHarness

AI 코딩 에이전트의 최근 세션 파일을 찾아 서로 참조하게 해주는 로컬 MCP 서버.

전용 하네스 없이 하네스처럼 동작한다. 기존 도구 환경을 그대로 유지하면서, 에이전트 간 세션을 연결하는 디스커버리 레이어.

Supported Agents (MVP)

AgentSession PathFormat
Claude Code~/.claude/projects/JSONL
Codex CLI~/.codex/sessions/JSONL
Gemini CLI~/.gemini/tmp/<hash>/chats/JSON

Prerequisites

  • Each agent must be able to read local files directly.
  • OpenHarness only provides paths and metadata — it does not transform, relay, or store session content.

Install

bash
npm install -g @freebird-ai/openharnessopenharness init

This registers OpenHarness as an MCP server in each agent's config.

MCP Tools

get_agent_sessions

Returns recent session paths for all agents, filtered by project.

Input:

json
{ "project": "/Users/me/my-app" }

Output:

json
[  {    "agent": "claude-code",    "path": "/Users/me/.claude/projects/-Users-me-my-app/session.jsonl",    "format": "jsonl",    "updatedAt": "2026-03-17T14:32:00Z",    "matchedProject": "/Users/me/my-app",    "matchedBy": "directory-name"  }]

get_agent_session

Returns the recent session path for a specific agent.

Input:

json
{ "agent": "claude-code", "project": "/Users/me/my-app" }

Output:

json
{  "agent": "claude-code",  "path": "/Users/me/.claude/projects/-Users-me-my-app/session.jsonl",  "format": "jsonl",  "updatedAt": "2026-03-17T14:32:00Z",  "matchedProject": "/Users/me/my-app",  "matchedBy": "directory-name"}

Returns null if no session is found.

Project Matching

AgentStrategy
Claude CodeProject path escaped with - as directory name
Codex CLIWorkspace field inside session JSONL
Gemini CLIProject path hash matching tmp/<hash>/

How It Works

User → Codex: "Review what Claude Code worked on recently"
Codex → OpenHarness MCP: get_agent_session({ agent: "claude-code", project: "..." })Codex ← receives session path + metadataCodex → reads the JSONL file directly and performs review

No rules needed in agent instruction files. MCP tool descriptions are enough for agents to use naturally.

Manual MCP Configuration

If you prefer to configure manually instead of using init:

json
{  "mcpServers": {    "openharness": {      "command": "openharness",      "args": []    }  }}

Add this to your agent's MCP config file:

AgentConfig File
Claude Code~/.claude/mcp.json or project .mcp.json
Codex CLIproject .codex/
Gemini CLI~/.gemini/settings.json

License

MIT

来源：README.md，提交 af0df79

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.1最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。