mcpField
A
Atuin

Atuin

Official
github.comDeveloper Tools32.1katuinUpdated today
RepositoryVisit website

About Atuin

Atuin stores shell history in a structured database with powerful search and cross-device synchronization. It captures execution time, working directory, exit code, and other metadata for each command, enabling developers to quickly locate and reuse past commands. History can be imported from existing shells and queried efficiently.

Key features

  1. 01Import and consolidate existing shell history
  2. 02Search history by command name, timestamp, or exit status
  3. 03Synchronize history across multiple machines
  4. 04Capture command execution context and metadata automatically

Use cases

  1. 01Quickly find and repeat complex build, test, or deployment commands in large projects
  2. 02Maintain consistent command history across multiple development machines
  3. 03Enable agent workflows that leverage shell history for context

Install

Pick your OS or package manager and run the command in a terminal.

$
brew install atuin

Once installed, runatuin --versionto confirm it works.

Example commands

Common commands in the order you’d use them.

01
atuin import auto
02
atuin search docker

Details

From the project README

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

magical shell history

README image README image README image README image README image README image README image

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.

animated

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

Supported platforms

Atuin supports zsh, bash, fish, nushell, xonsh, and PowerShell. See Supported platforms for the full matrix and what each tier means.

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.

Related projects

Please open a PR for any others!

Contributors

README image

Made with contrib.rocks.

Comments

Markdown supported