openharness

OpenHarness

AI コーディングエージェントの最近のセッションファイルを見つけ、相互に参照できるようにするローカル MCP サーバーです。

専用のハーネスなしで、ハーネスのように動作します。既存のツール環境をそのまま維持しながら、エージェント間のセッションをつなぐディスカバリーレイヤーです。

サポート対象のエージェント（MVP）

エージェント	セッションパス	形式
Claude Code	~/.claude/projects/	JSONL
Codex CLI	~/.codex/sessions/	JSONL
Gemini CLI	~/.gemini/tmp/<hash>/chats/	JSON

前提条件

• 各エージェントがローカルファイルを直接読み取れる必要があります。
• OpenHarness が提供するのはパスとメタデータのみです。セッション内容の変換、中継、保存は行いません。

インストール

npm install -g @freebird-ai/openharness
openharness init

これにより、各エージェントの設定で OpenHarness が MCP サーバーとして登録されます。

MCP ツール

get_agent_sessions

プロジェクトで絞り込んだ、すべてのエージェントの最近のセッションパスを返します。

入力：

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

出力：

[
  {
    "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"
  }
]

セッションが見つからない場合は null を返します。

get_agent_session

指定したエージェントの最近のセッションパスを返します。

入力：

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

出力：

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

セッションが見つからない場合は null を返します。

プロジェクトの照合

エージェント	方式
Claude Code	プロジェクトパスを - に置き換えたディレクトリ名
Codex CLI	セッション JSONL 内の Workspace フィールド
Gemini CLI	tmp/<hash>/ 内のプロジェクトパスのハッシュ照合

仕組み

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

エージェントの指示ファイルにルールを追加する必要はありません。MCP ツールの説明だけで、エージェントは自然に利用できます。

MCP の手動設定

init を使わず、手動で設定する場合：

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

エージェントの MCP 設定ファイルに以下を追加します。

エージェント	設定ファイル
Claude Code	~/.claude/mcp.json またはプロジェクトの .mcp.json
Codex CLI	プロジェクトの .codex/
Gemini CLI	~/.gemini/settings.json

ライセンス

MIT