Atuin

p:: CLI f:: zsh

Getting started | Atuin Docs

Atuin replaces your existing shell history with a SQLite database, and records additional context for your commands. With this context, Atuin gives you faster and better search of your shell history.

bash <(curl --proto '=https' --tlsv1.2 -sSf https://setup.atuin.sh)

 _______  _______  __   __  ___   __    _
|   _   ||       ||  | |  ||   | |  |  | |
|  |_|  ||_     _||  | |  ||   | |   |_| |
|       |  |   |  |  |_|  ||   | |       |
|       |  |   |  |       ||   | |  _    |
|   _   |  |   |  |       ||   | | | |   |
|__| |__|  |___|  |_______||___| |_|  |__|
 
Magical shell history
 
Atuin setup
https://github.com/atuinsh/atuin
 
Please file an issue if you encounter any problems!
 
===============================================================================
 
Detected Mac!
Installing with brew
 
...
 
==> Pouring atuin--17.2.1.arm64_sonoma.bottle.tar.gz
==> Caveats
zsh completions have been installed to:
  /opt/homebrew/share/zsh/site-functions
==> Summary
🍺  /opt/homebrew/Cellar/atuin/17.2.1: 11 files, 20.3MB
==> Running `brew cleanup atuin`...
Disable this behaviour by setting HOMEBREW_NO_INSTALL_CLEANUP.
Hide these hints with HOMEBREW_NO_ENV_HINTS (see `man brew`).
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 14256  100 14256    0     0  24462      0 --:--:-- --:--:-- --:--:-- 24452
 
 
 
 _______  __   __  _______  __    _  ___   _    __   __  _______  __   __
|       ||  | |  ||   _   ||  |  | ||   | | |  |  | |  ||       ||  | |  |
|_     _||  |_|  ||  |_|  ||   |_| ||   |_| |  |  |_|  ||   _   ||  | |  |
  |   |  |       ||       ||       ||      _|  |       ||  | |  ||  |_|  |
  |   |  |       ||       ||  _    ||     |_   |_     _||  |_|  ||       |
  |   |  |   _   ||   _   || | |   ||    _  |    |   |  |       ||       |
  |___|  |__| |__||__| |__||_|  |__||___| |_|    |___|  |_______||_______|
 
 
 
Thanks for installing Atuin! I really hope you like it.
 
If you have any issues, please open an issue on GitHub or visit our Discord (https://discord.gg/jR3tfchVvW)!
 
If you love Atuin, please give us a star on GitHub! It really helps ⭐️ https://github.com/atuinsh/atuin
 
Please run "atuin register" to get setup with sync, or "atuin login" if you already have an account

Import existing history | Atuin Docs

Atuin uses a shell plugin to ensure that we capture new shell history. But for older history, you will need to import it

atuin import auto

        Atuin
======================
          🌍
       🐘🐘🐘🐘
          🐢
======================
Importing history...
Detected ZSH
Importing history from zsh
████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████ 18147/18147
Import complete!

Setting up Sync | Atuin Docs

At this point, you have Atuin storing and searching your shell history! But it isn’t syncing it just yet. To do so, you’ll need to register with the sync server. All of your history is fully end-to-end encrypted, so there are no risks of the server snooping on you.

atuin register

Please enter username: adithya321
Please enter email: [email protected]
Please enter password:

After registration, Atuin will generate an encryption key for you and store it locally. This is needed for logging in to other machines, and can be seen with

atuin key

store this somewhere safe, such as in a password manager.

By default, Atuin will sync your history once per hour.

To run a sync manually

atuin sync

0/0 up/down to record store
Sync complete! 10141 items in history database, force: false

FAQ | Atuin Docs

How do I remove the default up arrow binding?

vim ~/.zshrc

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

source ~/.zshrc