README.md

Turn any topic or coding session into a beautiful, dark-mode, mobile-first explainer you can double-click to open. No server, no internet, no dependencies.

_{Self-contained offline HTML · sans-serif Inter font · inline SVG diagrams · zero JavaScript}

English · 简体中文 · 日本語 · Español · Français

What is this · Get started · In Claude Code · Anywhere (CLI) · FAQ · Comparison · Why trust it · Docs

See it in action

A real run of /recap "what is creatine", researched live, every claim fact-checked against primary sources (ISSN, NIH), then rendered to one self-contained page:

_{Animated walkthrough of a generated Recap Studio page about creatine: dark-mode hero, an inline-SVG energy-cycle diagram, icon key-idea cards, and a sources list citing NIH and ISSN.}

What is this

Recap Studio takes a topic ("Latest AI models") or a coding session (git diff + commits) and produces a single, self-contained HTML file: dark-mode, mobile-first, with a hero answer, takeaway cards, an inline SVG concept map, a timeline, a comparison table, misconceptions, a glossary, and cited sources.

The superpower no other tool has: the output is one .html file with every style inlined, zero JavaScript, and zero external requests. Double-click it in Finder or Explorer and it opens perfectly, with no Wi-Fi, no server, and no npm install.

What you get on the page:

Get started in 3 steps

1. Install the plugin from the 10x marketplace:

claude plugin marketplace add Aboudjem/10x
claude plugin install recap-studio@10x

2. Open any Claude Code session and run:

/recap "What is React Server Components"

3. A self-contained recap-<slug>.html opens in your browser. Done.

In Claude Code

Install once via the 10x marketplace (see above). Then use these commands anywhere in a Claude Code session:

After each run, the skill renders the self-contained HTML, opens it, and asks "Deploy to Vercel?" only if Vercel is configured and only with your explicit yes.

Install the skills into any AI CLI

Claude Code is the first-class host (via the 10x marketplace above). To load the four /recap skills directly into another CLI, run the one-line installer. It symlinks recap-topic, recap-session, recap-setup, and recap-validate into that CLI's skills directory; --update pulls the latest and relinks, --uninstall removes them.

curl -fsSL https://raw.githubusercontent.com/Aboudjem/recap-studio/main/install.sh | bash -s codex

On Windows, run install.ps1 <platform> from a checkout (Developer Mode or an elevated shell is needed for symlinks).

Skill-directory conventions change between CLI releases. If a link does not resolve, fall back to the optional local MCP server (it works in every MCP-capable client). Run install.sh all to link every platform at once. Build the MCP server once with pnpm -w build before adding it.

claude plugin marketplace add Aboudjem/10x
claude plugin install recap-studio@10x

claude mcp add recap-studio node -- packages/mcp-server/dist/index.js

{ "mcpServers": { "recap-studio": { "command": "node", "args": ["packages/mcp-server/dist/index.js"] } } }

{ "servers": { "recap-studio": { "type": "stdio", "command": "node", "args": ["packages/mcp-server/dist/index.js"] } } }

codex mcp add recap-studio -- node packages/mcp-server/dist/index.js

{ "mcpServers": { "recap-studio": { "command": "node", "args": ["packages/mcp-server/dist/index.js"] } } }

{ "mcpServers": { "recap-studio": { "command": "node", "args": ["packages/mcp-server/dist/index.js"] } } }

mcpServers:
  recap-studio: { command: node, args: ["packages/mcp-server/dist/index.js"], type: stdio }

The copy-paste setup, plus a smoke test for each editor, is in docs/multi-editor.md.

Anywhere (CLI)

Use the CLI when you are outside Claude Code: in any terminal, any editor, CI, or a cron job.

Install:

# Works today, from a clone of this repo:
git clone https://github.com/Aboudjem/recap-studio && cd recap-studio
pnpm install && pnpm -w build
node packages/cli/dist/index.js render content.json

# Planned: once @recap-studio/cli is published to npm, this becomes a one-liner.
# It is NOT on npm yet, so use the clone path above for now:
# npx @recap-studio/cli render content.json

Commands:

From the workspace root (if you cloned the repo):

pnpm -w render              # render the demo content
pnpm -w render:demo         # write artifacts/<slug>/recap-<slug>.html
pnpm -w demo:latest-ai-models && pnpm --filter recap-web dev

Other workspace scripts:

FAQ

Is the HTML really self-contained? Yes. All CSS is inlined. There is zero JavaScript and zero /_next/ or CDN references. Verified: 0 external refs, opens via file:// on a plane.

Does it work without an internet connection? For rendering: yes, completely offline. For the full LLM agent research pipeline (inside Claude Code), yes, it uses your local Claude Code session, not an external API you manage.

What is the "score"? recap validate runs a fast, deterministic heuristic check that scans structure, citation presence, word counts, and known quality signals. It does NOT fetch sources or run LLMs. The full LLM agent review (13 agents, 7 dimensions) only runs when you use /recap inside Claude Code. This is stated clearly in the output.

Can I use it in VS Code, Cursor, or Codex? Yes. The MCP server (@recap-studio/mcp-server) exposes a render_recap_html tool, and the recap CLI works in any terminal. The MCP transport is spec-compliant (content type "text", with notifications/initialized + ping) and unit-tested. Copy-paste setup for Claude Code, Cursor, VS Code, Codex, Gemini, Windsurf, and Continue, plus a smoke test for each, is in docs/multi-editor.md.

Does it deploy anywhere automatically? No. Deployment is disabled by default. It only deploys if you configure Vercel and give explicit consent when prompted.

Is there a hosted web version? Yes, via the Next.js track (pnpm --filter recap-web dev). The hosted track and the offline single-file track produce the same content across different rendering surfaces.

Comparison

The row that matters: self-contained offline HTML. No other explainer or changelog tool produces a double-clickable file with all styles inlined and no external deps.

Why trust it

• 43 tests pass across 5 test-bearing packages. Build is green. CI runs on every push.
• Two E2E use cases proven: topic explainer (fixtures/topics/latest-ai-models.json) and session recap (session.json, a recap of this codebase rebuild). Both render to validated self-contained HTML.
• Honest scoring: the heuristic score from validate is deterministic, so the same input always gives the same score. It is not an LLM opinion. No sources are fetched. The LLM review runs only inside Claude Code via /recap.
• Safe defaults: no network calls, no deploys, no emails, no secret writes, no destructive git, all off until you explicitly opt in. See docs/security-and-privacy.md.
• Open source, MIT: read every line. No telemetry, no data collection.
• Architecture is stable: hybrid plugin + skills + optional MCP. Reviewed and documented in docs/architecture.md.

Safety defaults

• No network. RECAP_STUDIO_FIXTURE_ONLY=1 is the starting state.
• No deploys. deploymentMode: "disabled".
• No emails. emailMode: "disabled".
• No secret writes. Hooks refuse .env*, PEMs, and key-shaped paths.
• No destructive git. Hooks refuse push --force, reset --hard, rebase, clean -fdx.

See hooks/README.md and docs/security-and-privacy.md.

Docs

• Architecture
• Agent system
• Workflows
• Vercel deployment
• Security and privacy
• Configuration
• Contributing
• Changelog

Star History

If Recap Studio helped you ship a better explainer, star it.
It helps other developers find tools that respect their attention.

_{Built by Adam Boudjemaa · MIT License · No telemetry · No data collection}