What is Atuin?
Atuin replaces your shell history with a searchable SQLite database, adding powerful full-text search, optional end-to-end encrypted sync across machines, and useful statistics. It records extra context for every command (exit code, duration, directory and more) and works with Bash, Zsh, Fish and other shells.
β‘ Key Features of Atuin
π Powerful Search
Full-text, fuzzy and prefix search over your entire shell history.
π Encrypted Sync
Optional end-to-end encrypted sync of history across all your machines.
π Rich Context
Records exit code, duration, directory and more for every command.
π Cross-shell
Works with Bash, Zsh, Fish and other popular shells.
π― Why Atuin?
- Better history: Searchable SQLite history that never silently truncates
- Sync across machines: End-to-end encrypted, self-hostable sync
- Context-rich: Know when, where and how each command ran
- Stats: Insights into your most-used commands
π Highlights
- SQLite History: Durable, queryable command history
- Interactive Search: Fuzzy search bound to your up arrow
- Sync: Optional encrypted multi-machine sync
- Stats: Command usage statistics
π¦ Installation from deb.griffo.io
Step 1: Add Repository
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt updateπ There is an always-free mirror. deb-free.griffo.io serves packages free forever, no account, no subscription, at most 2 months behind upstream, security fixes immediately. It currently carries cliamp, Ghostty, lazydocker, Oh My Posh and Zed; Atuin is not one of them, so the repository above is the only way to get it today, ask and it can be enrolled.
π§© About the extrepo option. extrepo is Debian's own tool for external repositories: it writes the sources file and installs the signing key for you, checking the key against signed metadata first. This repository is registered with it as griffo, and the always-free mirror as griffo-free, so on Debian (bookworm, trixie, forky and sid) the commands above are the whole setup.
extrepo sets up the sources file and the key only, so a subscription's credentials still go in /etc/apt/auth.conf.d/deb.griffo.io.conf. Ubuntu is not covered, because extrepo publishes metadata for Debian suites only: there, use the sudo or root commands.
Step 2: Install atuin
# Install latest atuin
sudo apt install atuin
# Verify installation
atuin --version# Install latest atuin
apt install atuin
# Verify installation
atuin --versionπ― Basic Usage Examples
# Show version
atuin --version
# Import existing shell history
atuin import auto
# Register with a sync server (optional)
atuin register -u <username> -e <email>
# Search history from the command line
atuin search docker
# Show usage statistics
atuin statsπ Why Choose deb.griffo.io?
- Official Debian: Often months behind, missing latest features
- deb.griffo.io: Latest version within hours of release
- Manual Installation: Manual downloads and PATH setup required
- Our Repository: Pre-built, ready-to-use packages
- β Latest Features: Get newest Atuin features and improvements immediately
- β No Manual Setup: Pre-built binaries, installed and updated through apt
- β Automatic Updates: Packages updated within hours of upstream releases
- β Proper Dependencies: Correctly packaged with all required libraries
- β Multi-Distribution: Works on Bookworm, Trixie, and Sid
- β Easy Maintenance: Simple apt commands for updates
π¦ Package Build Repository
The Debian packages are automatically built and maintained in this GitHub repository:
- π atuin-debian - Latest release builds
π Related Packages
Also available from deb.griffo.io:
- Starship - Fast, customizable cross-shell prompt
- zoxide - Smarter cd command for your terminal
- Zellij - Terminal workspace and multiplexer
π Support This Project
If this repository saves you time and effort, please consider supporting it!