Shell History Tools Compared: Atuin, fzf, McFly, hstr and Suvadu

There is no universal best shell history tool. Atuin, fzf, McFly, hstr, and Suvadu solve overlapping but different problems. If you are comparing Atuin alternatives, start with the workflow you want to improve: recalling commands, migrating existing history, syncing machines, or reviewing what coding agents did.

Review note: I build Suvadu, so read this as a maker's comparison. I reviewed it on 19 September 2026 against Suvadu 0.4.1 (source and release notes), Atuin's release-tagged documentation and current docs, and the current fzf, McFly, and hstr READMEs linked below. I updated the Suvadu search and import claims on 21 September 2026 for Suvadu 0.4.2, and re-checked the Atuin claims on 26 September 2026 against the Atuin v18.23.0 release (published 22 September 2026) and its release-tagged documentation. On 26 September 2026 I also re-checked every Suvadu claim for Suvadu 0.5.0 against its release notes and README.

Method: This is a documentation and source review, not a benchmark. I did not install the competing tools for this update or time any of them on the same hardware and history, so the article makes no speed ranking. Capabilities marked for another project are what its maintainers document; "not documented" means I did not find it in those pages, not proof that it cannot be done.

Choose by the job you need done

Next step: if your shortlist is Atuin and Suvadu, read the task-by-task Suvadu vs Atuin comparison. To try Suvadu now, use the install steps below or the installation guide.

brew tap AppachiTech/suvadu && brew install suvadu

curl -fsSL https://downloads.appachi.tech/suvadu/install.sh | bash

cargo install suvadu

eval "$(suv init zsh)"

source ~/.zshrc

eval "$(suv init bash)"

source ~/.bashrc

suv doctor

How the five tools differ

Atuin: strongest when shell history itself is the priority

Atuin records substantially more context than a normal history file: directory, duration, exit code, host, and session. Its search UI can scope results to a machine, directory, Git workspace, or shell session, and its search configuration offers fuzzy, prefix, full-text, and daemon-backed modes. The key-binding docs show both Ctrl+R and Up-arrow opening search by default, with --disable-up-arrow and --disable-ctrl-r to opt out.

Getting started is also easier. Its import reference documents atuin import auto and importers for Bash, Zsh, zsh-histdb, Fish, Nushell, xonsh, PowerShell, and more, and its support matrix covers more shells and platforms, including Windows, than anything else in this group. The sync guide describes optional end-to-end encrypted history across machines, hosted or self-hosted; registration is a sync step, not a requirement for local storage and search.

Atuin's AI support is current and concrete. Its agent hooks (atuin hook install claude-code, codex, opencode, or pi) record the Bash-tool commands those agents run, with author, directory, timestamp, exit code, and duration, and hide them from interactive search by default. Its built-in MCP server has three read-only tools: history search (with scope, failed-only, and author filters), a command's captured output, and, new in 18.23.0, search across captured output. Output capture is off by default and needs the daemon and PTY proxy, but when enabled an agent can read the actual error text of a failed command. Atuin also offers an optional built-in assistant, Atuin AI, with project and global skills and saved conversations it can resume. The 18.23.0 agent-hook docs do not describe capturing external agents' prompts or conversation transcripts; the AI session-capture interface listed in the generated 18.23.0 release notes was reverted before the release was tagged.

fzf: strongest when you want a reusable fuzzy selector

fzf is broader than shell history. It reads candidates from standard input (or its file walker) and returns a selection, which makes it useful for files, Git branches, processes, and custom lists as well as commands. Its shell integration supports Bash, Zsh, Fish, and Nushell and binds Ctrl+R to history search (for Zsh, source <(fzf --zsh)).

Choose fzf when matching flexibility and composability matter more than capturing a new structured history record. Because it searches the shell's own history, its results are only as complete as that history; if commands are not being saved, fix your shell's history settings first.

McFly: strongest when contextual ranking is the goal

McFly's defining idea is ranking. Its maintainer documentation says results consider directory, preceding commands, frequency, recency, prior selection, and historical exit status. It augments the normal history file with a SQLite database containing exit status, timestamp, and directory, so you can stop using it without losing your shell history.

This makes McFly a focused option for people who mainly want Ctrl+R to guess the relevant command. The project lists Bash, Zsh, and PowerShell 7+, and its README asks for co-maintainers; check the repository if maintenance cadence affects your decision.

hstr: strongest for a focused Bash/Zsh history browser

hstr offers a terminal suggest box for Bash and Zsh history. Its official README documents navigation, keyword, exact, and regex search, removal of obsolete or sensitive entries, command tags, and curated favorites. That is a useful combination if you want to stay close to the shell's history model, and it is packaged for many Linux distributions, macOS, and FreeBSD.

It does not present itself as a structured command-observability database. If directory, duration, exit status, session, or executor fields are central to your workflow, compare the database-backed options instead of treating every Ctrl+R UI as equivalent.

Suvadu: shell history plus agent-session review

Suvadu 0.5.0 supports Bash and Zsh and stores structured command context locally. Search defaults to literal words — each typed word must appear as a substring — ranked prefix, contiguous, in-order, then any-order. Since 0.4.2 you can switch that default with --match or Ctrl+X, including a fuzzy mode with classic subsequence matching, and narrow with --scope. Up/Down recall is recency-first, using the current directory only as a tiebreaker.

Its distinct workflow is reviewing and continuing agent work across tools. For Claude Code, Codex, and OpenCode, Suvadu captures the native session (prompts, assistant responses, observed models, and provider-reported token counts) as well as the commands. suv sessions shows human terminal sessions and agent sessions in one timeline. Over its MCP server, which exposes 21 read-only tools by default, a connected agent can read a previous session and, only if you set allow_session_summaries = true under [mcp], save a summary checkpoint that another agent can pick up. The requesting agent writes that summary; Suvadu stores it. Shared skills keep one set of instructions and write them into Claude Code, Cursor, and Codex's own files with suv skills sync. Prompt Explorer and agent reports cover prompt-to-command review and risk summaries.

The current limits are real and worth knowing before you switch:

• Search ranking: since 0.4.2, typed Ctrl+R search matches and counts across the whole eligible history in SQL, so an older command is found. The newest 5,000 matches are the ones ranked by relevance; anything beyond them is paged newest-first.
• Migration: suv import accepts Zsh history, Bash history, an Atuin database (--from atuin-db, read-only), and Suvadu JSONL. Bash history files carry no directory, exit code, or duration, and an untimestamped one carries no times either.
• Command output: Suvadu records whether a command failed, not its stdout or stderr. Session capture excludes tool results.
• Coverage: no Fish, Nushell, PowerShell, or Windows support, and no sync. Capture depends on initialized shell hooks and on each agent integration; some agents do not supply a structured exit status.

A practical recommendation

• Pick Atuin if better shell history is the main goal: fuzzy scoped search, easy import from almost any shell, Fish or Windows support, encrypted sync, or agent access to captured command output.
• Pick fzf when you want one highly configurable fuzzy selector for history and many other command-line tasks.
• Pick McFly when contextual ranking is the main improvement you want from Ctrl+R.
• Pick hstr for a focused Bash/Zsh history browser with favorites and history management.
• Try Suvadu when you use Bash or Zsh with several coding agents and want to inspect whole agent sessions, hand checkpoints between agents, and keep shared skills in one place, and you do not need sync, Fish, or Windows.

If your shortlist is Atuin and Suvadu, continue with the narrower Suvadu vs Atuin comparison. It walks through recovering a command, importing history, inspecting an agent session, and retrieving error output in each tool, and lists the migration limits in detail.

brew tap AppachiTech/suvadu && brew install suvadu

curl -fsSL https://downloads.appachi.tech/suvadu/install.sh | bash

cargo install suvadu

eval "$(suv init zsh)"

source ~/.zshrc

eval "$(suv init bash)"

source ~/.bashrc

suv doctor