Skip to content
Slipstream agent · Code

Release Notes

A release notes agent for Claude Code, Codex and Cursor

Release Notes writes user-facing release notes for the changes between two refs of a connected repository, from its merged pull requests and commits, and saves them as a doc. A run costs 900 credits, charged only when the run succeeds.

Or use it on slipstream.contextstream.io, signed in with your ContextStream account. Version 0.1.0 · Updated

What does Release Notes do?

Turns the merged pull requests and commits between two refs into user-facing release notes, accounting for every merged pull request, and saves them as a release_notes doc.

What it declines

A task like one of these is declined with a reason, and a declined run is free:

  • Tagging, publishing a release on the host, or changing the repository.
  • Describing a change no pull request or commit in the range makes.
  • Reviewing the changes (PR Reviewer does that).
  • A changelog for a range it cannot read: every note comes from the host's own record.

What does a real run of Release Notes look like?

The input, the result (shortened where it is long), how long it took, what it cost and where it ran. Live runs used public or demo material only; a run marked as from the eval suite is not a live run.

Live run on ContextStream

Release notes for v1.0.32 to v1.0.34 of a public MCP server

Version
0.1.0
Outcome
succeeded
Ran
2026-10-27 17:26 UTC
Took
7.8 s
Cost
900 credits

ContextStream's own workspace, reading the public tags and pull requests of github.com/contextstream/mcp-server through its GitHub connection. Release Notes reads no workspace memory, and this was a dry run: no doc was saved.

Input
{
  "repo": "contextstream/mcp-server",
  "base": "v1.0.32",
  "head": "v1.0.34",
  "dry_run": true
}

Result

Release notes for contextstream/mcp-server v1.0.32...v1.0.34: 3 merged pull requests (2 in the notes, 1 left out) and 0 other commits. Exhaustive search now scans the indexed commit literally, so every file and line containing the text is returned with true line numbers, and a row without the text is never marked high. Search hits from files kept for exact search only, such as minified or generated bundles, now say so, and index status counts those files by reason.

The notes (Markdown, as the doc would be saved)

# contextstream/mcp-server v1.0.34 release notes

Exhaustive search now scans the indexed commit literally, so every file and line containing the text is returned with true line numbers, and a row without the text is never marked high. Search hits from files kept for exact search only, such as minified or generated bundles, now say so, and index status counts those files by reason.

## Added

- MCP 1.0.34 shows which files are exact-search only ([#221](https://github.com/contextstream/mcp-server/pull/221))

## Fixed

- Exhaustive is `git grep -F -n` on the indexed commit; a row without the text is never "high" ([#216](https://github.com/contextstream/mcp-server/pull/216))

---

Changes from `v1.0.32` to `v1.0.34`: 3 merged pull requests and 0 other commits.

Every merged pull request in the range

Pull requestIn the notesWhy not
#216 fix(search): exhaustive is `git grep -F -n` on the indexed commit; a row without the text is never "high"included
#217 chore(release): prepare MCP 1.0.33omittedInternal change by its title or labels, left out of notes for users.
#221 feat: MCP 1.0.34 shows which files are exact-search onlyincluded
Checks: 1 of 3 passed
  • range_read: Read 3 commits.
  • pull_requests_accounted: 2 of 3 merged pull requests are in the notes and the rest are listed as left out with a reason; 3 pull requests the model missed added from their own title.
  • grounded: 1 entry resting on nothing in the range dropped.
Task
f94cfd15-9838-44f1-8693-66f5948b1915
Charged
0: it ran on ContextStream’s own account, which is not billed; a customer pays the price shown

What does Release Notes cost?

Release Notes costs 900 ContextStream credits a run, charged only when the run succeeds; a declined, failed, cancelled or timed-out run costs nothing. Credits come with every plan: Starter is free with 10,000 a month (11 runs of Release Notes, if spent on nothing else), and Pro is $19 a month with 25,000.

Which tools does Release Notes work with?

Claude Code, Codex, Cursor and other MCP clients: ContextStream's MCP gives them a slipstream tool that finds, runs and follows Release Notes. It also runs from a terminal or an agent's shell with ss run release-notes, and from the ContextStream web app.

  • Claude Code, Codex, Cursor and other MCP clients: connect ContextStream's MCP once (setup for each editor), then ask your agent to hand the job to Release Notes.
  • A terminal or an agent's shell: ss run release-notes, installed with ContextStream's command line.
  • The web app: the workspace's specialist library, where each run shows its price before it starts.

What access does Release Notes need?

Release Notes gets a short-lived token for one workspace, limited to 3 scopes: Reads repos, Writes one doc and Models via ContextStream. It works in one project, and only for that run.

Model agent. A program on ContextStream's model proxy, with a short-lived token that acts for you in one workspace. It is stopped after 4 min.

ScopeWhat it lets a run do
vcs.readRead the workspace’s connected repositories: pull requests, commits, comparisons and tags.
docs.writeWrite one doc per run, personal unless shared, recorded as the agent’s.
model.invokeCall models through ContextStream’s model proxy, under the run’s credit cap.

How do I turn Release Notes on?

An owner or admin of your ContextStream workspace turns Release Notes on in the specialist library of the web app. Specialist agents are opening workspace by workspace; if yours is not open yet, the library says so.

  1. Sign in to ContextStream: the button below opens the specialist library on Release Notes.
  2. An owner or admin switches Release Notes on for the workspace.
  3. Pick the project it works in, and run it from the library, from your coding agent or with ss run.

How do I call Release Notes from Claude Code or Codex?

Ask your coding agent to hand the job to Release Notes, or call it yourself: ss run release-notes in a terminal, or slipstream(action="run", agent="release-notes", input={...}) over MCP. A priced run starts only once its price is accepted.

Connect ContextStream's MCP (it also writes each editor's connection):

curl -fsSL https://contextstream.io/scripts/mcp.sh | bash

Notes for v1.3.0, saved as your own release_notes doc. Over MCP:

slipstream(action="run", agent="release-notes", input={"repo":"acme/api","base":"v1.2.0","head":"v1.3.0"}, accepted_price_credits=900)

In a terminal (curl -fsSL https://contextstream.io/cs/install.sh | sh installs ss):

ss run release-notes repo=acme/api base=v1.2.0 head=v1.3.0

Over MCP, a call without accepted_price_credits returns the quote first; ss asks on a terminal, and scripts pass --yes.

Input

FieldTypeWhat it is
repostring, requiredThe repository to write release notes for.
basestring, requiredThe previous release: a tag, branch or commit, for example v1.2.0.
headstring, requiredThe release: a tag, branch or commit, for example v1.3.0 or main.
titlestringThe notes' title. Defaults to the repository and the release ref.
audience"users" | "developers"users (the default) leaves internal changes out of the notes; developers keeps them under Internal.
project_idstringSave the notes in this project instead of the workspace.
sharedbooleanSave the notes for the whole workspace instead of as your own.
dry_runbooleanReturn the notes without saving them as a doc.
Code

PR Reviewer

pull request review agent

PR Reviewer reviews one pull request's diff for bugs and for breaches of the workspace's decisions, lessons and preferences, citing the line and the constraint for each finding.

1,200 credits a runEvals 13/13v0.1.0
Code

Code Oracle

code search agent

Code Oracle answers one question about where code is, what calls it, how it flows or where to change it, from the workspace's code index.

FreeEvals 202/212v0.2.0
Code

Docs Drift

documentation drift agent

Docs Drift finds statements in a repository's docs that its code no longer matches and proposes the edits as a diff.

800 credits a runEvals 7/7v0.1.0

Every Slipstream agent