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 分

    請在儲存庫或註冊中心條目中宣告授權條款。