Listed from the MCP registry; nobody on Odel publishes it.

MCP server: One MCP server.

Recap Studio

@aboudjemMCP server · External

Render and score one HTML page that explains your work or a topic. Opens offline, no JavaScript.

Version controlv0.6.4MITJavaScript
Freeno charge per call

Runs on your machine from its package; the steps are below.

A page made by Recap Studio: dark top banner, a one-sentence answer, and a numbered five-step reading path
From the README

What it does

  1. Reads
  2. Writes
  3. High impact

At most: creates or changes data: records, files, settings.

What it costs

Free

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).

MCP Bundlehttps://github.com/Aboudjem/recap-studio/releases/download/v0.6.4/recap-studio.mcpb

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.

README8 min read
Recap Studio: one page you can email, attach to a PR, or read on a plane. The image shows 40 commits that become one page, with the real line Verdict: PASS, 49.8 KB, 0 script tags, 9.7/10.

version License CI

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 doneOne page to sendChecked 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.

bash
npx -y github:Aboudjem/recap-studio demo

Real output from 2026-11-17, path shortened:

text
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`.
A page made by Recap Studio: dark top banner, a one-sentence answer, and a numbered five-step reading path

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.

Install

Recommended: the Vercel skills CLI. One command installs the skills for all your projects.

bash
npx skills add Aboudjem/recap-studio -g

skills.sh

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.

Claude Code Codex Cursor Gemini CLI GitHub Copilot OpenCode

Claude Code

Install tested.

bash
npx skills add Aboudjem/recap-studio -g -a claude-code -y

Codex

Tested: MCP call. Skills: install tested.

bash
npx skills add Aboudjem/recap-studio -g -a codex -y

Cursor

Install tested.

bash
npx skills add Aboudjem/recap-studio -g -a cursor -y

Gemini CLI

Install tested.

bash
npx skills add Aboudjem/recap-studio -g -a gemini-cli -y

GitHub Copilot

Install tested.

bash
npx skills add Aboudjem/recap-studio -g -a github-copilot -y

OpenCode

Install tested.

bash
npx skills add Aboudjem/recap-studio -g -a opencode -y

Only this project: drop -g. Another agent: put its name after -a.

Claude Code plugin

Adds the 13 research agents, safety hooks and the MCP server. Tested.

bash
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:

bash
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:

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

Other ways in
bash
# 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.

How it works

  1. You ask. /recap "<topic>" researches a topic. /recap session reads your git diff and commits.
  2. Agents write the content. 13 specialist agents find sources, write a five-minute reading path, and check each claim.
  3. The agent saves the content as JSON in artifacts/<slug>/content.json, in your project.
  4. A checker scores it. Seven fixed checks give the same score each time: structure, citations, word counts, secret scan. No model, no network.
  5. The renderer writes one file, 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 runsSide effect
Skills and agentsWrite files under artifacts/ in your project. Research uses your agent's own web search, when it has one.
CLI and MCP serverWrite the page you ask for. No network call. 11 MCP tools, listed in docs/mcp-tools.md.
Plugin hooksAct 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 emailNever run by the plugin. The MCP deploy tool returns a command to run yourself. The email tool returns a draft.

What you get

OutputWhat it is
recap-<slug>.htmlOne page in one file. All CSS inside, zero JavaScript, zero outside requests.
--format md or txtThe same page as Markdown or plain text, for a pull request or a note.
--printA paper version: white ground, black text, source URLs spelled out.
recap validateA 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.

Works with

AgentWhat was checkedTested
Claude Code 2.1.326Plugin loaded with --plugin-dir; its MCP server reported Connected from an unrelated folder2026-11-17
Codex CLI 0.169.0codex exec called the validate_content MCP tool and returned the verdict2026-11-17
Codex, Gemini CLI, OpenCode, Cursor, GitHub Copilotnpx skills@1.9.0 add -g copied all five skills into ~/.agents/skills/, for all projects2026-11-17

Documented, not tested: Windsurf, Continue, Zed and the other agents the skills CLI supports. Setup steps are in docs/editors.md.

Proof

Each number below comes from a command you can run in a clone.

ClaimNumberCommand
Tests pass115npm run test:count (runs npm test, prints the total)
Script tags in a rendered page0node bin/recap.mjs demo
Demo page size49.8 KBnode bin/recap.mjs demo
Score of the demo content9.7/10node bin/recap.mjs validate fixtures/topics/latest-ai-models.json
MCP tools11echo '{"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.

FAQ

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.

Limits

  • The score is a rough check (a heuristic). It checks shape, not truth. Read the sources before you share a page.
  • Research quality depends on your agent. The CLI renders the content you give it; it does not research.
  • Offline, Mermaid diagrams (text-based charts) show as text. Use SVG diagrams instead: kind: "svg".
  • Five MCP tools do not do the full job (they are stubs). render_page_screenshot, run_accessibility_scan and run_lighthouse_summary answer skipped: no browser ships with the server.
  • The deploy and email tools never deploy or send. deploy_vercel_preview returns a shell command to run yourself. send_email_draft returns a draft to paste into your mail client.
  • Codex may block the write tools. In a codex exec run, its approval review blocked render_recap_html. Read tools worked.

Learn more


Built by Adam Boudjemaa · MIT License · No telemetry

Similar modules

Browse Version control