From 3e7af55a9c43736a4155a794276597c73580cadd Mon Sep 17 00:00:00 2001 From: Ellie Huxtable Date: Sat, 13 Feb 2021 21:21:00 +0000 Subject: Update readme --- README.md | 45 ++++++++++++++++++++++++--------------------- 1 file changed, 24 insertions(+), 21 deletions(-) diff --git a/README.md b/README.md index b70820ad..851f71ce 100644 --- a/README.md +++ b/README.md @@ -5,11 +5,11 @@ 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! +A'tuin manages and synchronizes your shell history! Instead of storing +everything in a text file (such as ~/.history), A'tuin uses a sqlite database. +While being a little more complex, this allows for more functionality. -As well as the expected command, this stores +As well as the expected command, A'tuin stores - duration - exit code @@ -20,36 +20,34 @@ As well as the expected command, this stores ## Install -`atuin` needs a recent version of Rust + Cargo! It's best to use rustup for. +`atuin` needs a recent version of Rust + Cargo! It's best to use +[rustup](https://rustup.rs/) for getting set up there. ``` cargo install atuin ``` -and then add this to your ~/.zshrc +Once the binary is installed, the shell plugin requires installing: -``` -export ATUIN_SESSION=$(atuin uuid) +zplug: -_atuin_preexec(){ - id=$(atuin history start $1) - export ATUIN_HISTORY_ID="$id" -} +``` +zplug "ellie/atuin" +``` -_atuin_precmd(){ - local EXIT="$?" +antigen: - [[ -z "${ATUIN_HISTORY_ID}" ]] && return +``` +antigen use https://github.com/ellie/atuin.git +``` - atuin history end $ATUIN_HISTORY_ID --exit $EXIT -} +oh-my-zsh: -add-zsh-hook preexec _atuin_preexec -add-zsh-hook precmd _atuin_precmd +``` +git clone https://github.com/ellie/atuin ~/.oh-my-zsh/plugins/atuin ``` -We're not replacing anything here, so your default shell history file will still -be written to! +and then add `atuin` to your `plugins` list in `~/.zshrc` ## Usage @@ -65,3 +63,8 @@ atuin import zsh # specify shell ``` atuin history list ``` + +## ...what's with the name? + +A'tuin is named after "The Great A'tuin", a giant turtle from Terry Pratchett's +Discworld series of books. -- cgit v1.2.3