v0.6.1
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 annotations — readOnlyHint: 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_outputto find text,list_commandsto browse,get_outputto read one output,diff_outputfor "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
.mcpbbundle (attached below) is generated from the release artifacts in CI, and the MCP Registry entryio.github.soren-achebe/backscrollis published via GitHub OIDC in the same workflow. - Also since the last notes: the repo now ships a
Dockerfilethat runsbackscroll 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.