Skip to content
atuinshPublic

About

✨ Making your shell magical

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

32.4k stars

Watchers

75 watching

Forks

Latest commit

 

History

2,628 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Text changing depending on mode. Light: 'So light!' Dark: 'So dark!'

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

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.

Searching shell history with ctrl-r, then picking a match

Agents can search your history too:

Claude Code finding a command from your shell history through Atuin's MCP server

As well as the search UI, atuin has a CLI interface for searching commands:

# 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.

Claude Code recalling a decision from last week's Codex thread through Atuin's MCP server

You can take a session you started on your personal computer in Claude Code, and $ atuin resume it in a remote machine inside Codex.

A Claude Code thread on a laptop, resumed in Codex over ssh on another machine

Similarly to the history index, you can search through your threads:

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

Please open a PR for any others!

Community

Contributors

We are very grateful to all our contributors!

Made with contrib.rocks.

About

✨ Making your shell magical

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

32.4k stars

Watchers

75 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages