Skip to content

v0.6.1

Choose a tag to compare

@github-actions github-actions released this 26 Jul 21:57

A small, MCP-focused release. If you don't point AI agents at your terminal history, nothing changes for you.

MCP: tools now say what they are

All four tools (search_output, list_commands, get_output, diff_output) now carry MCP tool annotationsreadOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false — plus human-readable titles. Every backscroll tool is a pure read of the local recording database; clients and agent frameworks that gate on annotations (e.g. auto-approving read-only tools) can now see that instead of guessing.

Tool descriptions were also rewritten to spell out what agents actually need to know:

  • the output format (plain text, ANSI stripped, secrets masked by default),
  • when to use which tool (search_output to find text, list_commands to browse, get_output to read one output, diff_output for "what changed since last run?"),
  • error behavior (not found, no-previous-run, empty results),
  • and that nothing is ever re-executed — these tools read recordings.

A unit test now pins titles + annotations on every tool; the definitions were cross-checked with @modelcontextprotocol/inspector.

Packaging

  • This is the first release built and published fully automatically end-to-end: the .mcpb bundle (attached below) is generated from the release artifacts in CI, and the MCP Registry entry io.github.soren-achebe/backscroll is published via GitHub OIDC in the same workflow.
  • Also since the last notes: the repo now ships a Dockerfile that runs backscroll mcp, with a containerized smoke test in CI.

Install

curl -fsSL https://raw.githubusercontent.com/soren-achebe/backscroll/main/install.sh | sh

or brew install soren-achebe/tap/backscroll, or the .deb/.rpm/tarballs below. Upgrading from any 0.x: drop-in, no migration.