atuin

atuin command [options]

atuin replaces your shell history with a SQLite database, providing powerful search, context tracking, and optional end-to-end encrypted sync across machines.It records additional context like exit status, duration, working directory, and hostname, making history search more powerful than traditional Ctrl+R.

search [query]

Interactive history search. Supports filtering by directory, session, host, or globally.

Import existing history (auto, bash, zsh, fish, nu, xonsh, resh, and others).

Synchronize history with the Atuin server (upload and download).

Authenticate with sync server.

Register a new account on the Atuin sync server.

Remove authentication.

Display or set the encryption key used for end-to-end encrypted sync.

Show usage statistics and command frequency.

History management (list, delete, etc.).

Output shell setup code for bash, zsh, fish, or nu.

Run diagnostics to check for common issues with the installation.

Display system and configuration information.

Manage and sync shell aliases and environment variables.

~/.config/atuin/config.toml

Main configuration file for search settings, sync options, database path, filter mode, search mode, and UI preferences.

Add to shell rc file:

$ eval "$(atuin init bash)"  # or zsh, fish

$ eval "$(atuin init zsh --disable-up-arrow)"

Requires shell initialization code. Sync feature is optional (can be used fully offline). Database can grow large over time. Some shells require specific configuration for proper integration.

atuin was created by Ellie Huxtable and released in 2021, offering modern shell history with end-to-end encrypted sync, statistics, and improved search.

history(1), mcfly(1), hstr(1), fzf(1), bash(1), zsh(1)