32,505
stars
1,048
forks
75
watchers
3,151
prs
1,475
issues
104
releases
README
making your terminal magical
Atuin gives you, and your agents, a history of everything that happened in your terminal.
Shell history Atuin replaces your shell history with a SQLite database that records exit codes, working directories, hosts and durations. Hit Ctrlr and find any command you've ever
run, on any machine.
Agent Threads Atuin captures your Claude Code, Codex, OpenCode and other agent sessions. Start a thread on your laptop, then atuin resume it on a different machine, in a different harness.
Your agents can, optionally, search everything that's ever happened through the built-in MCP server.
Atuin can also sync both history and threads across all of your machines, end-to-end encrypted. Or it can work totally offline!
Quick Start
bash
curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh
Then, restart your shell.
History
Atuin captures everything you do in the terminal, storing it into a SQLite
database. Hitting CTRLr opens a pretty pane with all
your bash history. Atuin logs your _exit codes_, _working directories_,
_hostnames_, _command duration_ and much much more. You can
hit Return to execute a command, Tab to edit any
highlighted command.
Agents can search your history too:
As well as the search UI, atuin has a CLI interface for searching commands:
bash
search for all successful make commands, recorded after 3pm yesterday
atuin search --exit 0 --after "yesterday 3pm" make
Threads
Atuin captures what your agents do. Automatically move your
context and thread history from one machine to another, or from one harness to
another.
With _Atuin Threads_, your agent has access to your full history, and the
built-in Atuin MCP gives your agent context on everything you've ever done.
You can take a session you started on your personal computer in Claude Code,
and $ atuin resume it in a remote machine inside Codex.
Similarly to the _history_ index, you can search through your _threads_:
bash
atuin threads search 'c++'
Sync
Atuin syncs all your AI threads, your shell sessions across all your computers
(even ephemeral VMs!). You can either use the official Atuin
Service or you can self-host the sync server. Everything it
syncs is end-to-end encrypted.
Atuin supports
zsh,
bash,
fish,
nushell,
xonsh and
PowerShell
as well as
Claude Code,
Codex,
Opencode,
Copilot,
Grok,
Hermes,
and many more.
Atuin does so much more and we have extensive
documentation! If you ever need help, reach out to us
through our communities.
Related projects
Catpuccin for Atuin
eshell-atuin
mob (tiny creatures in your terminal)
Please open a PR for any others!
Community
Contributors
We are very grateful to all our contributors!
_Made with contrib.rocks._Top issues
#798Replace native up arrow more seamlessly40 comments · 2023-03-22#1405Supporting atuin in Warp (terminal)25 comments · 2023-11-20#2438[Bug]: Error: Permission denied (os error 13)19 comments · 2024-11-03#2491[Bug]: first command of bash session is not saved17 comments · 2024-12-20#1926[Bug]: Can not introduce symbols14 comments · 2024-04-06#2663[Suggestion]: Don't use `AlertError` for current selection highlight13 comments · 2025-04-02#1324Atuin with mosh won't repaint properly13 comments · 2023-10-25#2375[Bug]: Atuin seems to randomly "forget" lots of history also strange fuzzy search behavior.12 comments · 2024-08-28
Latest release
18.24.8 v18.24.8 2026-11-13Release Notes Bug Fixes - (release) Build musl artifacts with a musl C++ toolchain for Luau (4723) Documentation - List the Threads page in the AI section of the nav (4722) Features - Update whats-new.txt (4724) atuin 18.24.8 Install atuin 18.24.8 Install prebuilt binaries via shell script sh curl --proto '=https' --tlsv1.2 -LsSf https://github.com/atuinsh/atuin/releases/download/v18.24.8/atuin-installer.sh | sh Install prebuilt binaries via powershell script sh powershell -ExecutionPolicy Bypass -c "irm https://github.com/atuinsh/atuin/releases/download/v18.24.8/atuin-in