---
title: "Making Your Shell Magical with Atuin"
url: https://stacklist.com/card/644ce31e-8090-4d8a-b79a-03d8ec005b11
source_url: "https://github.com/atuinsh/atuin"
stack: https://stacklist.com/stack/e311a40b-2cff-4429-b917-63135f507d81
summary: "Atuin is a shell history tool that replaces the default history file with a SQLite database, recording additional context like exit codes, duration, and working directory while offering encrypted cross-machine synchronization. It supports multiple shells including zsh, bash, fish, and nushell, and provides a full-screen search UI, statistics, and flexible filtering modes."
tags: "shell-history, atuin, sqlite, command-line, encrypted-sync, terminal, open-source"
key_entities: "Atuin (technology), SQLite (technology), bash (technology), zsh (technology), fish (technology), nushell (technology), encrypted synchronization (concept), Atuin Cloud (organization), bash-preexec (technology)"
classification: "reference"
content_hash: "sha256:f1e61c0c556beeacd360f9f06d79956383186db90a6ee5eb84c3c16a4b04b123"
acp_version: "0.2"
token_counts_approximate: 610
visibility: public
agent_accessible: true
status: "final"
---

# Making Your Shell Magical with Atuin

magical shell history English | 简体中文 Atuin replaces your existing shell history with a SQLite database, and records additional context for your commands. Additionally, it provides optional and fully encrypted synchronisation of your history between machines, via an Atuin server. exit code, duration, time and command shown As well as the search UI, it can do things like this: # search for all successful `make` commands, recorded after 3pm yesterday atuin search --exit 0 --after "yesterday 3pm" make You may use either the server I host, or host your own! Or just don't use sync at all. As all history sync is encrypted, I couldn't access your data even if I wanted to. And I really don't want to. Features rebind ctrl-r and up (configurable) to a full screen history search UI store shell history in a sqlite database back up and sync encrypted shell history the same history across terminals, across sessions, and across machines log exit code, cwd, hostname, session, command duration, etc calculate statistics such as "most used command" old history file is not replaced quick-jump to previous items with Alt-<num> switch filter modes via ctrl-r; search history just from the current session, directory, or globally enter to execute a command, tab to edit Documentation Quickstart Install Setting up sync Import history Basic usage Supported Shells zsh bash fish nushell xonsh powershell (tier 2 support) Community Forum Atuin has a community forum, please ask here for help and support: https://forum.atuin.sh/ IRC We're also available via #atuin on libera.chat Discord Atuin also has a community Discord, available here Quickstart This will sign you up for the Atuin Cloud sync server. Everything is end-to-end encrypted, so your secrets are safe! Read the docs for an offline setup, self-hosted server, and more. curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh atuin register -u <USERNAME> -e <EMAIL> atuin import auto atuin sync Then restart your shell! Note For Bash users : The above sets up bash-preexec for necessary hooks, but bash-preexec has limitations. For details, please see the Bash section of the shell plugin documentation. Security If you find any security issues, we'd appreciate it if you could alert ellie@atuin.sh Related projects Catpuccin for Atuin eshell-atuin mob (tiny creatures in your terminal) Please open a PR for any others! Contributors Made with contrib.rocks .