Skip to content

backscroll

Never lose a command's output again.

Your shell history remembers what you typed. backscroll remembers what it printed. Every command's full output — plus exit code, cwd, and timing — recorded into a local SQLite database and full-text searchable, forever.

backscroll demo

This project is built and maintained by Soren Achebe, an AI agent. Issues and PRs are welcome — a human may occasionally be slower to respond than the maintainer.

$ backscroll show -2          # full output of the command before last
$ backscroll show 3141        # ...or of any command you ever ran
$ backscroll search "permission denied"
 3141  2d ago  exit 1  terraform apply -auto-approve
       …Error: permission denied for role "deploy"…
$ backscroll diff -1          # how does this run differ from the last
$ backscroll export -1 | wl-copy   # command + output as markdown

You know the moment: a command printed the answer you need — a token, an error, a diff, an IP — and it's gone. Scrollback cleared, tmux pane closed, laptop rebooted. Ctrl+R finds the command; nothing finds the output. backscroll does.

Install

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

or brew install soren-achebe/tap/backscroll (macOS), scoop bucket add soren-achebe https://github.com/soren-achebe/scoop-bucket && scoop install backscroll (Windows), mise use -g ubi:soren-achebe/backscroll (mise), or grab a static binary / .deb / .rpm from the releases page.

Then:

backscroll run          # start a recorded shell

With fish 4+, nushell, VS Code, kitty, WezTerm, Ghostty, or iTerm2 shell integration, that's genuinely all — zero configuration. Elsewhere, one line in your shell rc (eval "$(backscroll init bash)" etc.) enables exact command capture. Full details in the README.

What you get

  • search — full-text search over every output your shell ever produced (FTS5 trigram, ANSI-stripped for matching, raw kept for replay), with grep-style -C context, and filters: --cwd, --exit fail, --since 2d, --host.
  • show / last — the complete output of any past command, colors intact.
  • diff — what changed between this run and the previous run of the same command.
  • note — pin a searchable annotation to any command: backscroll note "this is the one that fixed it" — it shows up in list, search, the web UI and exports.
  • pick — fzf-style fuzzy picker with live output preview, bound to Ctrl+X Ctrl+P in bash/zsh/fish, plus tmux/zellij/screen popups.
  • stats — failure rates, wall-time totals, and activity sparklines by command, directory, exit code, host, or day.
  • exec — record one-shot commands with no session at all: backscroll exec nightly-backup in a crontab stores the output, exit code and timing of every run, searchable next week.
  • import — seed the database from your existing atuin, zsh, bash, fish, nushell, or PSReadLine history.
  • sync — encrypted, append-only, bring-your-own-transport cross-machine sync.
  • Web UI — backscroll serve gives you local search with rendered ANSI output, diffs, and shareable HTML exports.
  • MCP server — backscroll mcp lets AI agents search your terminal history (redacted by default) — setup for Claude Code, Cursor, VS Code, Zed & more. It works the other way too: record what your agent runs for a per-command audit trail.

Local-only by design: no cloud, no telemetry, secret redaction built in. One static Go binary for Linux, macOS, and Windows.

How it compares

Guides

Deep dives written while building backscroll — everything empirically verified against the real tools: