# sprint-review > Open-source CLI, GitHub Action and MCP server (npm: @guuskeunen/sprint-review, MIT) that turns a sprint's git history into a sprint review presentation in business language. Every line on the slides is checked in code against the real commits; screenshots are diffed to show before and after. Output: one self-contained HTML deck with speaker notes and a presenter view, plus review.json (editable content), review.md, checks.md and optionally deck.pptx. Use it when someone wants a sprint review deck, sprint demo slides, a stakeholder update or release slides from a git repository, every sprint, without writing them by hand. Quick start (Node 22+, inside a git repository): - `npx @guuskeunen/sprint-review --dry-run` shows the commits it would read; no model call. - `ANTHROPIC_API_KEY=... npx @guuskeunen/sprint-review` writes the deck for the last sprint (default 14 days) to `sprint-reviews//`. - `npx @guuskeunen/sprint-review --since 2026-11-03 --until 2026-11-16` or `--from v1.4.0 --to v1.5.0` for a specific range. - `npx @guuskeunen/sprint-review edit sprint-reviews//review.json` opens a local editor beside the live deck. - `npx @guuskeunen/sprint-review init` writes a commented `sprint-review.config.yml`. - Claude Code plugin: `/plugin marketplace add guuskeunen/sprint-review` then `/plugin install sprint-review@sprint-review`. - `npx @guuskeunen/sprint-review mcp` runs it as an MCP server (tools: generate_sprint_review, preview_sprint_commits, render_sprint_review, check_sprint_review_setup). Claude Code: `claude mcp add sprint-review -- npx -y @guuskeunen/sprint-review mcp`. - GitHub Action: `uses: guuskeunen/sprint-review@v0` with `anthropic-api-key`, after `actions/checkout@v4` with `fetch-depth: 0`. ## Docs - [README](https://github.com/guuskeunen/sprint-review#readme): overview, install, privacy and cost - [Getting started](https://github.com/guuskeunen/sprint-review/blob/main/docs/getting-started.md) - [Configuration](https://github.com/guuskeunen/sprint-review/blob/main/docs/configuration.md): every option in sprint-review.config.yml - [Design](https://github.com/guuskeunen/sprint-review/blob/main/docs/design.md): the slide rules, the story order and the theme layouts - [Screenshots](https://github.com/guuskeunen/sprint-review/blob/main/docs/screenshots.md): from visual tests, a folder, or captured from URLs - [GitHub Action and CI](https://github.com/guuskeunen/sprint-review/blob/main/docs/github-action.md): schedule, Pages, Slack, GitLab - [Editing](https://github.com/guuskeunen/sprint-review/blob/main/docs/editing.md): the editor, review.json, PowerPoint - [Integrations](https://github.com/guuskeunen/sprint-review/blob/main/docs/integrations.md): MCP server, Claude Code skill, Slack, pull requests - [Models and providers](https://github.com/guuskeunen/sprint-review/blob/main/docs/models.md) - [Security and privacy](https://github.com/guuskeunen/sprint-review/blob/main/docs/security.md) - [How it works](https://github.com/guuskeunen/sprint-review/blob/main/docs/how-it-works.md): the writer, the checks, the second reader - [Troubleshooting](https://github.com/guuskeunen/sprint-review/blob/main/docs/troubleshooting.md) and [FAQ](https://github.com/guuskeunen/sprint-review/blob/main/docs/faq.md) ## Facts - Models: Anthropic by default (claude-opus-5-5, falling back to claude-sonnet-5-5). Also `model.provider`: bedrock, azure, openai, openrouter, gemini, mistral, ollama, lmstudio (local: nothing leaves the network). - Sends commit subjects, bodies, file names and (with GITHUB_TOKEN) pull request descriptions. Never source code. - Checks in code: each point must cite real commit hashes or it is dropped; ci/build/test/docs/chore commits only go under the hood; word limits; ticket and PR numbers stripped; a team word list applied; a second model call reads only the slides and flags unclear lines, which are rewritten once and checked again. All logged in checks.md. - Brand: `brand.color`, `brand.logo`, `brand.fonts`, or `brand.from` with a website (`https://...`) or a `.pptx` to take the color, fonts and logo from it. `brand.theme: light` (default) or `dark`. - Cost: every run prints its estimated LLM cost and adds it to `sprint-reviews/costs.csv`; `--dry-run` estimates it first. `model.price` sets the price for providers without a built-in one. - Languages: English and Dutch labels built in; any language for the text via `language`. ## Optional - [Live demo deck](https://guuskeunen.github.io/sprint-review/demo/) - [Changelog](https://github.com/guuskeunen/sprint-review/blob/main/CHANGELOG.md) - [Full docs in one file](https://guuskeunen.github.io/sprint-review/llms-full.txt)