Atuin is a shell history tool designed to replace your existing shell history with a SQLite database. It records additional context for each command, such as exit codes, durations, timestamps, and working directories, providing a more comprehensive and searchable history experience.
Key Features:
Replaces traditional shell history with a SQLite database for faster and more reliable storage.
Records detailed metadata for commands, including exit codes, cwd (current working directory), hostname, session ID, and command duration.
Offers optional, fully encrypted synchronization of your command history across machines via an Atuin server.
Provides a consistent history experience across terminals, sessions, and devices.
Features a full-screen search UI that allows users to query history with advanced filters (e.g., by exit code, time range, or command content).
Supports keyboard shortcuts like Alt+ for quick navigation and configurable bindings for ctrl-r and up arrow functionality.
Audience & Benefit:
Ideal for power users, developers, and anyone who relies on shell history for productivity. Atuin helps users quickly retrieve past commands, analyze usage patterns, and maintain consistent access to their command history across environments. By storing metadata alongside commands, it enables more precise searches and insights into workflow efficiency.
Available via winget, Atuin is a robust tool for enhancing shell productivity while ensuring privacy and security through optional encrypted synchronization.
README
magical shell history
Atuin replaces your existing shell history with a SQLite database, and records
additional context for your commands. Additionally, it provides optional and
fully encrypted synchronisation of your history between machines, via an Atuin
server.
exit code, duration, time and command shown
As well as the search UI, it can do things like this:
# search for all successful `make` commands, recorded after 3pm yesterday
atuin search --exit 0 --after "yesterday 3pm" make
You may use either the server I host, or host your own! Or just don't use sync
at all. As all history sync is encrypted, I couldn't access your data even if
I wanted to. And I really don't want to.
Features
rebind ctrl-r and up (configurable) to a full screen history search UI
store shell history in a sqlite database
back up and sync encrypted shell history
the same history across terminals, across sessions, and across machines
Atuin supports zsh, bash, fish, nushell, xonsh, and PowerShell. See
Supported platforms for the full matrix
and what each tier means.
Community
Forum
Atuin has a community forum, please ask here for help and support:
IRC
We're also available via #atuin on libera.chat
Discord
Atuin also has a community Discord, available here
Quickstart
This will sign you up for the Atuin Cloud sync server. Everything is end-to-end encrypted, so your secrets are safe!
Read the docs for an offline setup, self-hosted server, and more.
curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh
atuin register -u -e
atuin import auto
atuin sync
Then restart your shell!
> [!NOTE]
>
> For Bash users: The above sets up bash-preexec for necessary hooks, but
> bash-preexec has limitations. For details, please see the
> Bash
> section of the shell plugin documentation.