Boost Your Shell Productivity with Atuin: Installation, Sync, and Advanced Usage

Atuin is a modern replacement for the traditional shell history, storing each command in an SQLite database along with context such as exit status, hostname, session, and current working directory. It offers optional real‑time synchronization via a public server or a self‑hosted instance, with all data encrypted.

Key features include:

SQLite‑based storage for all user input.

Immediate availability of commands across multiple terminals or systems.

Encrypted backup and sync, using either a public server or a self‑hosted solution.

Contextual metadata (exit code, cwd, hostname, session, duration, etc.) stored with each entry.

Rebinding of Ctrl+R and UP to a full‑screen history search UI (configurable).

Legacy history files remain accessible and are updated live.

Simple, hassle‑free configuration for Bash, Fish, and Zsh.

How to Install Atuin on Linux

For a single‑machine installation, run the following command:

bash <(curl https://raw.githubusercontent.com/atuinsh/atuin/main/install.sh)

After installation you can choose one of three actions: start using Atuin immediately, register a new account on the public server with atuin register, or log in to an existing account with atuin login.

Using Atuin After Installation

Restart your terminal session to apply the new shell configuration. You can then access the full‑screen search UI via Ctrl+R, the UP arrow, or by running atuin search -i. The UI shows each command with its index, duration, and execution time, and supports scrolling with the arrow keys.

To filter results, type the initial characters of the desired command. Press ENTER to execute the selected command, Tab to return to the shell for editing, or ESC / DOWN to exit.

Statistics and History Management

View command usage statistics (total executions, unique commands, etc.) with: atuin stats Import your existing shell history automatically: atuin import auto List all recorded entries, including timestamps and durations: atuin history list Search for successful executions (exit code 0) of a specific command, e.g., ping: atuin search --exit 0 ping Filter by date and time, for example, successful ping commands before yesterday at 5 pm:

atuin search --exit 0 --after "yesterday 5pm" ping

Run atuin --help for a full list of commands. Beginners are advised to understand traditional shell history first, as Atuin may not be beneficial in every scenario.