Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
作者による説明(英語の原文)
Recap AI coding sessions (Claude Code, Codex, dsh, OpenCode): intent, decisions, open threads.
この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。
このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。
使っているAIアプリを選んで、設定をコピーしてください。
必要なもの
どのアプリを使っていますか?
上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。
Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます
{
"mcpServers": {
"session-recap": {
"command": "npx",
"args": [
"-y",
"session-recap",
"mcp"
]
}
}
}ターミナルでこれを実行します
claude mcp add session-recap -- npx -y session-recap mcpプロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます
{
"mcpServers": {
"session-recap": {
"command": "npx",
"args": [
"-y",
"session-recap",
"mcp"
]
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
プロジェクトの .vscode/mcp.json に貼り付けます
{
"servers": {
"session-recap": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"session-recap",
"mcp"
]
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。
選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月6日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント BruceXcluding で確認済みです
このリポジトリはまだGitHubから読み取っていません
このリポジトリはまだGitHubから読み取っていません
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は–、最新バージョン(0.6.1)がレジストリに届いたのは今日です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
同じカテゴリには:Spec Driven Development, Remote Desktop Commander, dotnet-mcp
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
MCP server for .NET symbols, XAML, source generators, and restricted workspace edit
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
English | 中文
Remember what every AI coding session was for.
intent · key decisions · what changed · open threads · where to resume, for sessions of any length, from any agent, through MCP, a local viewer or a plugin
Projects grow, and so does the number of sessions in each one, often across several agents. After a few weeks a session is a 100 MB transcript you no longer remember: why you started it, what you decided, what was left half done.
session-recap reads a session's whole transcript and writes a short, structured recap. Use it from any MCP client (Codex, Cursor, Zed, Cline, Gemini CLI, OpenCode, Claude Code…), in a local viewer for every agent's sessions, from the command line, or through native plugins for Claude Code, dsh and Codex.
| Section | What it answers |
|---|---|
| Intent | What was I ultimately trying to achieve? |
| Key ideas and decisions | What did we choose, and why? Which alternatives were rejected? |
| What changed | Files, features, documents, commits, PRs |
| Open threads | What is unfinished, unverified or still a question |
| Where to resume | The most sensible next step today |
Every recap also has a Map: the phases the work went through (pivots marked) down to "you are here", the key decisions with what was turned down, and lists of what shipped, what is open and what was dropped. Recaps are written in the language you mostly write in.
npm install -g session-recap
session-recap mcp-config # prints the MCP entry for your client session-recap serve # opens the local viewer
Then, in your agent: *"Recap this session"*, *"What was my last session in this project about?"*, *"总结一下这个会话"*.
No API key needed. Through MCP, the agent you are talking to writes the recap with its own model; session-recap only reads and condenses the transcript. A model of session-recap's own is optional (for the CLI and the viewer's Write recap button).
Or run it without installing: npx session-recap …. session-recap has no dependencies and runs no install scripts. The development version: npm install -g github:BruceXcluding/session-recap --allow-git=all (npm 12 blocks installs from GitHub without the flag).
Requirements: Node.js 20+, python3 (macOS ships one), and for dsh sessions the zstd command or Python 3.14+.
| Best for | How | |
|---|---|---|
| MCP server | any MCP client | session-recap mcp-config , see below |
| Local viewer | browsing every agent's sessions, Recap and Map | session-recap serve |
| Claude Code plugin | a Recap / Map pane beside the chat | /plugin install session-recap --marketplace BruceXcluding/session-recap |
| dsh plugin | /recap and the session_recap tool in dsh | packages/dsh |
| Codex plugin | the MCP server, packaged for Codex | plugins/codex |
| Command line | scripts, quick looks, other formats | session-recap, session-recap list |
session-recap mcp-config prints the entry for claude, codex, cursor, gemini (and Qwen Code), opencode, zed, vscode or cline, with absolute paths so an IDE started from the dock finds it. For example:
session-recap mcp-config codex >> ~/.codex/config.toml
claude mcp add --scope user session-recap -- session-recap mcp
Tools:
| Tool | What it does |
|---|---|
list_sessions | Sessions of every agent, filtered by title words, project folder or agent |
recap_session | The recap of the current session (or one named): a stored one if the session has not changed; else written by session-recap's model if one is configured; else the condensed, secret-free transcript and instructions for the calling agent to write it |
save_recap | Stores the recap the agent wrote, so it is reused, and updated from the new part next time |
recap_session also takes format: standup, handoff or pr instead of the recap.
session-recap serve opens http://127.0.0.1:4711 with every agent's sessions by project folder, grouped by time, filtered by agent; each session's Recap and Map; and, with a model configured, Write recap and Update recap. It reads the recaps written by the Claude Code plugin, the CLI and MCP clients alike. It answers only on loopback, to the browser tab it opened.
/session-recap recaps the session you are in; /session-recap browse lists projects and sessions; /session-recap opens a project or a session by name. The pane shows Recap and Map, uses the session's own model (or one picked under Model), and shows your Claude Code sessions first, with All agents one tap away.
| Command | What it does |
|---|---|
session-recap [words] | Recaps the session whose title holds the words; with none, the newest one in this folder |
session-recap list [words] | Lists sessions (the calling agent's; --all for every agent) |
session-recap --format standup | A standup note instead (handoff, pr) |
session-recap --dry-run | Shows the size that would be sent, and how many secrets were removed, without calling a model |
session-recap models | Lists your provider's models |
session-recap config set model | Saves settings (partModel, api, baseUrl; the key with config set apiKey - from stdin) |
The CLI's own model: SESSION_RECAP_API (anthropic or openai), SESSION_RECAP_BASE_URL, SESSION_RECAP_API_KEY, SESSION_RECAP_MODEL, or ANTHROPIC_*, DEEPSEEK_API_KEY, OPENAI_API_KEY.
| Agent | Sessions read from |
|---|---|
| Claude Code | ~/.claude/projects/ |
| Codex | ~/.codex/sessions/, archived_sessions/ (review threads left out) |
| dsh (deepseek-harness) | ~/.dsh/sessions/ (zstd; subagent sessions left out) |
| OpenCode | ~/.local/share/opencode/opencode.db |
Want another? Adding an agent is one reader and one test, or ask for it.
PASSWORD=…-style assignments are replaced with [REDACTED: ] before any text reaches a model. --dry-run shows how many. It is pattern matching, so it cannot know every format: see SECURITY.md.Listing never calls a model. On a real 179 MB Claude Code session (220 prompts), a first recap sends about 195k characters (~96k tokens); when the session continues, an update reads only the new prompts. Long sessions are condensed in parts of ≤75k characters, each part's notes cached, and a cheaper model can condense the parts (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)
Output is versioned: see docs/data-format.md and schema/recap-v1.schema.json to build your own viewer or exporter.
Agents, recap formats, translations and viewers are all welcome. Start with CONTRIBUTING.md; adding an agent and adding a format (one entry in core/formats.mjs) are the easiest first contributions.
MIT