atuin(1)
Atuin is a magical shell history search tool that syncs, backs up, and intelligently searches your command history across machines.
Synopsis
atuin [COMMAND] [OPTIONS]Description
Atuin replaces your shell's default history with a SQLite database, providing powerful search, statistics, and sync capabilities. It works with bash, zsh, fish, and other shells, capturing command context like exit status, duration, and working directory.
Key features include fuzzy search with preview, history sync across devices with encrypted backups, and detailed command statistics. Your history is private by default—sync is opt-in and end-to-end encrypted.
Common options
| Flag | What it does |
|---|---|
search | Interactive search through your command history with preview |
history | Manage local history database (list, delete, import, export) |
stats | Display statistics about your command usage patterns |
sync | Sync history with remote server (requires login) |
login | Authenticate with Atuin server for history sync |
logout | Log out from Atuin server and stop syncing |
import | Import history from another shell (bash, zsh, fish) |
--limit N | Limit search results to N entries (default 100) |
--filter-mode | Set filter mode (session, directory, or global) |
--reverse | Reverse search result order (newest first by default) |
Examples
Open interactive fuzzy search with preview of matching commands
atuin searchShow last 20 commands from local history database
atuin history list --limit 20Display command frequency, top commands, and usage patterns
atuin statsAuthenticate with Atuin server to enable cloud sync
atuin loginManually sync history with remote server (usually auto-syncs)
atuin syncAuto-detect shell and import existing history into Atuin
atuin import autoDelete all history entries from current directory
atuin history delete --cwdExport full history as JSON and compress for safe backup
atuin history export | gzip > backup.gz