English Français العربية

io.github.philo-kim/openharness

السجل الرسمي أدوات المطورين

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @freebird-ai/openharness
Claude Code 
claude mcp add openharness -- npx -y @freebird-ai/openharness@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "openharness": {
            "command": "npx",
            "args": [
                "-y",
                "@freebird-ai/openharness@0.1.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. OpenHarness
  2. Supported Agents (MVP)
  3. Prerequisites
  4. Install
  5. MCP Tools
  6. Project Matching
  7. How It Works
  8. Manual MCP Configuration
  9. License

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

npm install -g @freebird-ai/openharness
openharness 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:

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

Output:

[
  {
    "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:

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

Output:

{
  "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 + metadata
Codex → 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:

{
  "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

الأسئلة الشائعة

ما هو io.github.philo-kim/openharness؟

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

كيف أثبّت io.github.philo-kim/openharness؟

يعمل على جهازك. في Claude Code: claude mcp add openharness -- npx -y @freebird-ai/openharness@0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.philo-kim/openharness إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.philo-kim/openharness مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.philo-kim/openharness؟

ينشره philo-kim. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.