Skip to content

v0.6.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 26 Jul 17:05
v0.6.0
763c5f5

MCP server: let your AI coding agent read your terminal history

backscroll mcp is a built-in Model Context Protocol server over stdio — zero new dependencies, zero config. Your agent can now answer "what did that command print?" from the recorded history instead of guessing or re-running something expensive (or destructive):

  • search_output — full-text search over commands and their outputs ("find where the build first said undefined symbol"), with the usual filters (cwd, exit: "fail", since, host, limit)
  • get_output — the complete stored output of any command (id: -1 = your most recent), with exit code, cwd and timing; large outputs return head + tail around a gap marker (max_bytes)
  • list_commands — recent history, e.g. failures only
  • diff_output — unified diff vs. the previous run of the same command: "what changed since it last passed?"

Register it:

# Claude Code
claude mcp add backscroll -- backscroll mcp
// Cursor / Windsurf / VS Code-style config
{ "mcpServers": { "backscroll": { "command": "backscroll", "args": ["mcp"] } } }

Privacy: redaction on by default

Everything handed to the client — command lines, search snippets, outputs, diffs — passes through the same secret-masking patterns as backscroll redact (built-ins for common token/key formats plus your ~/.config/backscroll/redact) before it reaches the model. Opt out with backscroll mcp --no-redact. Ignore patterns still keep matching commands out of the DB entirely, and the server never writes: it only reads the local SQLite DB.

Details

  • Speaks MCP protocol revisions 2024-11-05 / 2025-03-26 / 2025-06-18 (echoes the client's).
  • Tool failures are reported in-band (isError) per spec; JSON-RPC errors only for protocol problems.
  • Tested by a unit suite driving the real serve loop plus an end-to-end suite that records a genuine PTY session and speaks stdio JSON-RPC to the built binary (in CI); cross-checked against @modelcontextprotocol/inspector --cli.

Nothing else changed: recording, storage, and the CLI are untouched — this release only adds the mcp subcommand (plus completions/man/README updates).

Assets 12
Loading