session-recap

session-recap

英語 | 中文

すべてのAIコーディングセッションの目的を記録します。

_{セッションの長さを問わず、どのエージェントのセッションでも、MCP、ローカルビューアー、プラグインを通じて、意図・重要な決定・変更点・未解決の課題・再開場所を記録します}

     

---

プロジェクトが成長するにつれて、それぞれのプロジェクトのセッション数も増えていきます。多くの場合、複数のエージェントをまたいで増えていきます。数週間もすると、セッションはもう覚えていない100 MBのトランスクリプトになります。なぜ始めたのか、何を決めたのか、何が中途半端に残っているのかも分からなくなります。

session-recapはセッションのトランスクリプト全体を読み込み、簡潔で構造化された要約を作成します。あらゆるMCPクライアント（Codex、Cursor、Zed、Cline、Gemini CLI、OpenCode、Claude Codeなど）から、すべてのエージェントのセッションを確認できるローカルビューアーから、コマンドラインから、またはClaude Code、dsh、Codex向けのネイティブプラグインから利用できます。

セクション	分かること
意図	最終的に何を達成しようとしていたのか？
重要なアイデアと決定	何を選び、その理由は何か？どのような代替案を却下したのか？
変更点	ファイル、機能、ドキュメント、コミット、PR
未解決の課題	未完了、未検証、またはまだ疑問として残っていることは何か？
再開場所	今日、次に取り組むのに最も適切なことは何か？

各要約にはマップも含まれます。作業がたどった各フェーズ（方向転換した箇所には印が付きます）を「現在地」まで示し、却下した案とともに重要な決定を記録します。また、リリース済みのもの、未解決のもの、取り下げたものの一覧も含まれます。要約は、主に使用している言語で作成されます。

クイックスタート

npm install -g session-recap
session-recap mcp-config            # prints the MCP entry for your client
session-recap serve                 # opens the local viewer

次に、エージェントで 「このセッションを要約して」、「このプロジェクトでの前回のセッションはどんな内容でしたか？」、「总结一下这个会话」 と入力します。

API キーは不要です。 MCP を通じて、会話相手のエージェントが自身のモデルで要約を書きます。session-recap はトランスクリプトを読み取り、要約するだけです。session-recap 独自のモデルは任意です（CLI とビューアーの Write recap ボタンで使用します）。

インストールせずに実行することもできます：npx session-recap …。session-recap に依存関係はなく、インストールスクリプトも実行しません。開発版を使う場合：npm install -g github:BruceXcluding/session-recap --allow-git=all（npm 12 では、このフラグがないと GitHub からのインストールがブロックされます）。

要件： Node.js 20 以上、python3（macOS には標準で付属しています）、および dsh セッションでは zstd コマンドまたは Python 3.14 以上。

使用方法

	最適な用途	方法
MCP サーバー	あらゆる MCP クライアント	session-recap mcp-config <client>。下記を参照してください
ローカルビューアー	すべてのエージェントのセッションの閲覧、Recap と Map	session-recap serve
Claude Code プラグイン	チャットの横に Recap / Map ペインを表示	/plugin install session-recap --marketplace BruceXcluding/session-recap
dsh プラグイン	dsh で /recap と session_recap ツールを使用	packages/dsh
Codex プラグイン	Codex 向けにパッケージ化された MCP サーバー	plugins/codex
コマンドライン	スクリプト、簡単な確認、その他の形式	session-recap、session-recap list

MCP サーバー

session-recap mcp-config <client> は、claude、codex、cursor、gemini（および Qwen Code）、opencode、zed、vscode、cline の設定エントリーを出力します。絶対パスが使われるため、Dock から起動した IDE でも見つけられます。例：

session-recap mcp-config codex >> ~/.codex/config.toml
claude mcp add --scope user session-recap -- session-recap mcp

ツール：

ツール	機能
list_sessions	タイトルのキーワード、プロジェクトフォルダー、エージェントで絞り込んだ、すべてのエージェントのセッション一覧
recap_session	現在のセッション（または指定したセッション）の要約。セッションに変更がなければ保存済みの要約、変更があればモデルが設定されている場合は session-recap のモデルが作成した要約、それ以外の場合は秘密情報を除去した短縮版トランスクリプトと、呼び出し元のエージェントが要約を作成するための指示を返します
save_recap	エージェントが作成した要約を保存し、再利用できるようにします。次回は新しい部分をもとに更新されます

recap_session では、要約の代わりに format として standup、handoff、pr も指定できます。

ローカルビューアー

session-recap serve を実行すると、http://127.0.0.1:4711 が開きます。すべてのエージェントのセッションがプロジェクトフォルダー別、時系列でグループ化され、エージェントで絞り込めます。各セッションの Recap と Map も表示されます。モデルを設定している場合は、Write recap と Update recap も使用できます。Claude Code プラグイン、CLI、MCP クライアントが作成した要約も読み込みます。ループバックインターフェースでのみ応答し、開いたブラウザータブにのみ応答します。

Claude Code プラグイン

/session-recap は現在のセッションを要約し、/session-recap browse はプロジェクトとセッションを一覧表示します。/session-recap <name> は名前を指定してプロジェクトまたはセッションを開きます。ペインには Recap と Map が表示され、セッション独自のモデル（または Model で選択したモデル）が使われます。自分の Claude Code セッションが最初に表示され、ワンタップで All agents に切り替えられます。

コマンドライン

コマンド	機能
session-recap [words]	タイトルに指定した語句を含むセッションを要約します。語句を指定しない場合は、このフォルダー内で最も新しいセッションを要約します
session-recap list [words]	セッションを一覧表示します（呼び出し元エージェントのセッション。すべてのエージェントを対象にするには --all を指定）
session-recap --format standup	代わりにスタンドアップ用メモを作成します（handoff、pr も指定可能）
session-recap --dry-run	モデルを呼び出さずに、送信されるサイズと削除される秘密情報の数を表示します
session-recap models	プロバイダーのモデルを一覧表示します
session-recap config set model <id>	設定を保存します（partModel、api、baseUrl。キーは標準入力から config set apiKey - で設定）

CLI 独自のモデルは、SESSION_RECAP_API（anthropic または openai）、SESSION_RECAP_BASE_URL、SESSION_RECAP_API_KEY、SESSION_RECAP_MODEL、または ANTHROPIC_*、DEEPSEEK_API_KEY、OPENAI_API_KEY で指定します。

対応エージェント

エージェント	読み込み元のセッション
Claude Code	~/.claude/projects/
Codex	~/.codex/sessions/、archived_sessions/（レビューのスレッドは除外）
dsh (deepseek-harness)	~/.dsh/sessions/（zstd；サブエージェントのセッションは除外）
OpenCode	~/.local/share/opencode/opencode.db

ほかのエージェントも必要ですか？エージェントの追加は、リーダーを1つとテストを1つ追加するだけです。またはリクエストしてください。

プライバシー

• ローカルで処理します。 セッションはお使いのマシンで読み込まれます。テキストが外部に送信されるのは、要約に必要なモデル呼び出し（エージェントのもの（MCP、プラグイン）または設定したもの（CLI、ビューアー））に限られます。テレメトリーはありません。
• シークレットは事前に削除されます。 キー、トークン、秘密鍵、URL内の認証情報、PASSWORD=…形式の代入は、モデルにテキストが送信される前に[REDACTED:<kind>]に置き換えられます。--dry-runでは件数を確認できます。パターンマッチングによる処理のため、すべての形式を検出できるわけではありません。SECURITY.mdを参照してください。
• 送信される内容は、簡潔にまとめられたトランスクリプトです。プロンプト、各ターンの最終回答、コミットとPR、編集されたファイルが含まれます。ツールの出力と中間回答は除外されます。

トークンの使用量

一覧表示ではモデルを呼び出しません。実際の179 MBのClaude Codeセッション（220件のプロンプト）では、最初の要約で約**195k文字（約96kトークン）**が送信されます。セッションが続く場合、更新時には新しいプロンプトだけを読み込みます。長いセッションは75k文字以下の部分に分割して要約し、各部分のメモをキャッシュします。また、より低コストのモデルで各部分を要約することもできます（partModel）。

動作の仕組み

saved sessions (Claude Code · Codex · dsh · OpenCode)
        │
hooks/digest.py      one reader per agent → turns (prompt, actions, final reply, edits) → secrets removed
        │
core/recap.mjs       parts → notes (parallel, cached) → one call writes the recap and its map, or updates it
        │
MCP server · viewer · CLI · Claude Code pane · dsh tool and /recap      (one cache: ~/.cache/session-recap)

出力はバージョン管理されています。独自のビューアーやエクスポーターを作成するには、docs/data-format.mdとschema/recap-v1.schema.jsonを参照してください。

コントリビューション

エージェント、要約形式、翻訳、ビューアーのコントリビューションを歓迎します。CONTRIBUTING.mdから始めてください。エージェントの追加や、形式の追加（core/formats.mjsに項目を1つ追加するだけ）は、最初のコントリビューションとして最適です。

ライセンス

MIT