Listed from the MCP registry; nobody on Odel publishes it.
Render and score one HTML page that explains your work or a topic. Opens offline, no JavaScript.
Runs on your machine from its package; the steps are below.

At most: creates or changes data: records, files, settings.
Odel charges nothing per call. The publisher may charge for its own service.
Runs locally over stdio
This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).
Distributed as an MCP bundle (`https://github.com/Aboudjem/recap-studio/releases/download/v0.6.4/recap-studio.mcpb`) — download it and import the bundle in your MCP client.
English · 简体中文 · 日本語 · Español · Français
Understand what changed, in one page you can send.
Recap Studio makes one HTML page from your coding session or a topic.
| Understand what was done | One page to send | Checked before you send |
|---|---|---|
/recap session reads your git diff and commits, then writes one page. | One HTML file, 0 script tags, all CSS inside. The demo below prints both. | Seven checks score the page with no model; --fail-under 8 refuses a weak page. |
Works with: any agent that reads skills, and any MCP client (tested: Claude Code, Codex CLI). The page builder needs no model; the writing uses your agent's model.
Try it now. You only need Node 20 or later.
npx -y github:Aboudjem/recap-studio demo
Real output from 2026-11-17, path shortened:
Verdict: PASS. Wrote /tmp/try/recap-latest-ai-models.html
Page: 49.8 KB, 0 script tags, all CSS inlined. Score: 9.7/10, 0 blocker(s).
Next:
- Open the file with a double-click. It works offline.
- Make your own: `npx -y github:Aboudjem/recap-studio example -o content.json`, edit it, then `npx -y github:Aboudjem/recap-studio render content.json`.
- Score it before you send it: `npx -y github:Aboudjem/recap-studio validate content.json --fail-under 8`.
What it is: a tool that turns your coding session or a topic into one HTML page.
When to use it: someone asks what changed this week, or what a topic means.
What you get: one file to email or attach to a pull request. It opens offline, with no JavaScript and no network request.
The score checks shape, not truth, so read the sources before you share.
Recommended: the Vercel skills CLI. One command installs the skills for all your projects.
npx skills add Aboudjem/recap-studio -g
Works in more than 70 agents: pick yours in the menu (supported agents). npx skills is Vercel's open installer for agent skills. Page: skills.sh/aboudjem/recap-studio.
In a terminal it shows the agent menu. In a script it installs into every agent folder, so add -a <agent> there.
It installs the skills only. The MCP server is a separate one-line step: see An MCP client below.
Or install straight into one agent. Each command installs for all your projects.
Install tested.
npx skills add Aboudjem/recap-studio -g -a claude-code -y
Tested: MCP call. Skills: install tested.
npx skills add Aboudjem/recap-studio -g -a codex -y
Install tested.
npx skills add Aboudjem/recap-studio -g -a cursor -y
Install tested.
npx skills add Aboudjem/recap-studio -g -a gemini-cli -y
Install tested.
npx skills add Aboudjem/recap-studio -g -a github-copilot -y
Install tested.
npx skills add Aboudjem/recap-studio -g -a opencode -y
Only this project: drop -g. Another agent: put its name after -a.
Adds the 13 research agents, safety hooks and the MCP server. Tested.
claude plugin marketplace add Aboudjem/10x
claude plugin install recap-studio@10x
Then type /recap "What is React Server Components" in any project.
claude plugin list may say "The packages it lists were not installed". You can ignore it: the plugin needs no packages.
The CLI alone. No agent needed. It runs from GitHub, not npm:
npx -y github:Aboudjem/recap-studio render content.json
In this README and the docs, recap is short for npx -y github:Aboudjem/recap-studio. The CLI prints its hints in the form you used to start it.
An MCP client (an app that calls tools over the Model Context Protocol). Paste this into its MCP config:
{
"mcpServers": {
"recap-studio": {
"command": "npx",
"args": ["-y", "github:Aboudjem/recap-studio", "mcp"]
}
}
}
The Claude Code plugin starts this server for you. Setup for each editor is in docs/editors.md.
# This project only, for the agents the skills CLI finds
npx skills add Aboudjem/recap-studio
# The repo's own installer, which calls the same skills CLI
curl -fsSL https://raw.githubusercontent.com/Aboudjem/recap-studio/main/install.sh | bash -s codex
# From a clone, with no network after the clone
git clone https://github.com/Aboudjem/recap-studio && cd recap-studio
node bin/recap.mjs demo
Each release also ships recap-studio.mcpb, a one-file bundle for MCP clients that install bundles.
/recap "<topic>" researches a topic. /recap session reads your git diff and commits.artifacts/<slug>/content.json, in your project.artifacts/<slug>/recap-<slug>.html. All CSS is inside the file.The CLI and the MCP server are one committed file, bin/recap.mjs, with no dependency.
| What runs | Side effect |
|---|---|
| Skills and agents | Write files under artifacts/ in your project. Research uses your agent's own web search, when it has one. |
| CLI and MCP server | Write the page you ask for. No network call. 11 MCP tools, listed in docs/mcp-tools.md. |
| Plugin hooks | Act only when the session runs inside a recap-studio project (see the FAQ). There they block destructive git and unchecked deploys. They also block writes and edits to secret files. That means .env and .env.* and anything under secrets/ or private/. It also means SSH key files (id_rsa, id_ed25519, id_ecdsa, id_dsa, with or without .pub) and .pem, .p12, .pfx, .keystore and .key files. |
| Deploy and email | Never run by the plugin. The MCP deploy tool returns a command to run yourself. The email tool returns a draft. |
| Output | What it is |
|---|---|
recap-<slug>.html | One page in one file. All CSS inside, zero JavaScript, zero outside requests. |
--format md or txt | The same page as Markdown or plain text, for a pull request or a note. |
--print | A paper version: white ground, black text, source URLs spelled out. |
recap validate | A report that opens with the verdict, then up to three fixes, then seven scored dimensions. |
--fail-under <score> | Exit 1 below your gate. A blocker fails the run whatever the score. |
| Agent | What was checked | Tested |
|---|---|---|
| Claude Code 2.1.326 | Plugin loaded with --plugin-dir; its MCP server reported Connected from an unrelated folder | 2026-11-17 |
| Codex CLI 0.169.0 | codex exec called the validate_content MCP tool and returned the verdict | 2026-11-17 |
| Codex, Gemini CLI, OpenCode, Cursor, GitHub Copilot | npx skills@1.9.0 add -g copied all five skills into ~/.agents/skills/, for all projects | 2026-11-17 |
Documented, not tested: Windsurf, Continue, Zed and the other agents the skills CLI supports. Setup steps are in docs/editors.md.
Each number below comes from a command you can run in a clone.
| Claim | Number | Command |
|---|---|---|
| Tests pass | 115 | npm run test:count (runs npm test, prints the total) |
| Script tags in a rendered page | 0 | node bin/recap.mjs demo |
| Demo page size | 49.8 KB | node bin/recap.mjs demo |
| Score of the demo content | 9.7/10 | node bin/recap.mjs validate fixtures/topics/latest-ai-models.json |
| MCP tools | 11 | echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node bin/recap.mjs mcp |
CI runs the suite on Node 20 and 22 on every push and pull request. It also fails if a rendered page holds a <script> tag.
Do I need Claude Code to use it?
No. The CLI and the MCP server run anywhere Node 20 runs. Claude Code adds the research agents behind /recap.
Does the page call home when I open it?
No. It has no JavaScript and no external link to load. CI checks every render for a <script> tag.
Is the 9.7/10 score a review by a model? No. It is a set of fixed checks over structure, citations and word counts. They give the same score each time. They do not read the sources.
Will the hooks change my other projects?
No. They check the session's working folder, not the folder of the file being edited. They act only when that folder or a parent has a recap-studio.config.* file, a .recap-studio/ folder, or is this repo. RECAP_HOOKS_EVERYWHERE=1 turns them on everywhere.
Why not publish the CLI to npm?
It does not need it. The CLI is one file with no dependency, so npx -y github:Aboudjem/recap-studio runs it directly.
kind: "svg".render_page_screenshot, run_accessibility_scan and run_lighthouse_summary answer skipped: no browser ships with the server.deploy_vercel_preview returns a shell command to run yourself. send_email_draft returns a draft to paste into your mail client.codex exec run, its approval review blocked render_recap_html. Read tools worked.Built by Adam Boudjemaa · MIT License · No telemetry