A'tuin

Through the fathomless deeps of space swims the star turtle Great A’Tuin, bearing on its back the four giant elephants who carry on their shoulders the mass of the Discworld.

atuin manages and synchronizes your shell history! Instead of storing everything in a text file (such as ~/.history), atuin uses a sqlite database. This lets us do all kinds of analysis on it!

As well as the expected command, this stores

• duration
• exit code
• working directory
• hostname
• time
• a unique session ID

Install

atuin needs a recent version of Rust + Cargo! It's best to use rustup for.

cargo install atuin

and then add this to your ~/.zshrc

``` export ATUIN_SESSION=$(atuin uuid)

atuinpreexec(){ id=$(atuin history start $1) export ATUINHISTORYID="$id" }

atuinprecmd(){ local EXIT="$?"

[[ -z "${ATUIN_HISTORY_ID}" ]] && return

atuin history end $ATUIN_HISTORY_ID --exit $EXIT

}

add-zsh-hook preexec atuinpreexec add-zsh-hook precmd atuinprecmd ```

We're not replacing anything here, so your default shell history file will still be written to!

Usage

Import history

atuin import auto # detect shell, then import atuin import zsh # specify shell

List history

atuin history list