Skip to content

Atuin

Atuin replaces your shell history with a SQLite database, and records extra context for every command: the directory it ran in, how long it took, whether it succeeded, and which machine and session it came from. That context is what makes search actually useful.

It can also sync your history across all of your machines, end-to-end encrypted. Use our server, host your own, or skip sync entirely and stay local.

Quickstart

bash <(curl --proto '=https' --tlsv1.2 -sSf https://setup.atuin.sh)

Restart your shell, then press Ctrl+R or the Up arrow to search. Type a query, press enter to run the selected command, or tab to put it on your command line for editing.

To bring your existing history with you:

atuin import auto

To sync it across machines — optional, and covered in Setting up sync:

atuin register -u <USERNAME> -e <EMAIL>
atuin sync

If you'd rather take it one step at a time, Getting Started walks through the same thing with more explanation. From there, Basic usage covers driving the TUI, and Config documents every setting.

Supported platforms

Atuin supports zsh, bash, fish, nushell, xonsh, and PowerShell. See Supported platforms for the full matrix and what each tier means.

Getting help

Open a topic on the forum, join our Discord, or file an issue. If something isn't working, atuin doctor collects the details we'll ask for.