canido.dev
Projects/atuinsh / atuin

Atuin

Searchable, synced shell history with an AI command helper

Get it on GitHub
Unclaimed

Built by @atuinsh on GitHub. This page was written by @iluxav from public sources, last updated for v18.23.0 (2026-09-21), and may lag behind new releases.

Maintain Atuin? Claim it
v18.23.0 / 2026-09-2115 things you can do17 changes to know before upgradingFollow (Atom feed)

Search your shell history with Ctrl-R, record each command's context, sync history encrypted between machines, and now capture and search command output.

What you can do with it

Search your shell history in a full-screen view bound to Ctrl-R and the up arrow.

Present at v18.8.0

Record each command with its exit code, directory, host, session and duration in a SQLite database.

Good to know

Your old history file is kept; Atuin keeps its own database alongside it.

Present at v18.8.0

Limit a history search to the current session, directory or host, or search everything.

Present at v18.8.0

Query history from the command line, for example successful `make` runs after 3pm yesterday.

Present at v18.8.0

Sync your shell history between machines, encrypted end to end, through Atuin's server or your own.

Good to know

Needs an account on a sync server; the server cannot read the history.

Present at v18.8.0

See statistics about your history, such as your most used commands.

Present at v18.8.0

Import the history your shell already has.

Present at v18.8.0

Open a past command in an interactive inspector that shows its details.

Since v18.10.0
Show all 15

Define your own keybindings in the search view, including vim motions and media keys.

Since v18.12.1

Run a background daemon that starts on its own and keeps a fast in-memory search index.

Since v18.13.3

Read and set Atuin settings from the command line with `atuin config`.

Since v18.15.2

Record the shell commands that coding agents run, through hooks Atuin installs.

Since v18.15.2

Let AI tools search your shell history through Atuin's MCP server.

Since v18.17.1

Generate a shell command or ask a question in plain words with `atuin ai`.

Good to know

Uses Atuin Hub; signing in to Hub turns on sync.

PreviewSince v18.13.3

Capture the output of the commands you run so you or your tools can read it later.

PreviewSince v18.17.1

Before you upgrade

Newest first
v18.21.02026-08-31

The default socket is now `$TMPDIR/atuin-$UID/atuin.sock` (or `$XDG_RUNTIME_DIR/atuin.sock` with `systemd_socket`); clients still find a daemon at the old paths.

Behavior changedAffects: Setups that point at the daemon socket path
Read the evidence
v18.21.02026-08-31

Install Rust 1.98 or newer before building this release.

Action requiredAffects: People building Atuin from source
Read the evidence
Show 14 older
v18.19.02026-08-03

The V1 sync protocol is removed; switch to sync v2 by setting `records = true` in the `[sync]` config before upgrading.

Action requiredInferredAffects: Clients still syncing with the V1 protocol (`records = false`)
Read the evidence
v18.17.12026-07-14

Install Rust 1.97 or newer before building this release.

Action requiredAffects: People building Atuin from source
Read the evidence
v18.16.12026-05-12

`atuin hex` is now `atuin pty-proxy` and `ATUIN_PTY_PROXY_*` replaces `ATUIN_HEX_*`; the old names still work.

Behavior changedAffects: Users of `atuin hex`
Read the evidence
v18.16.02026-04-28

Install Rust 1.95 or newer before building this release.

Action requiredAffects: People building Atuin from source
Read the evidence
v18.13.32026-03-16

Install Rust 1.94 or newer before building this release.

Action requiredAffects: People building Atuin from source
Read the evidence
v18.12.12026-02-11

The server is now a separate `atuin-server` binary; install it and run that instead of the server built into `atuin`.

Action requiredInferredAffects: People who self-host a sync server with `atuin server start`
Read the evidence
v18.12.12026-02-11

Install Rust 1.93 or newer before building this release.

Action requiredAffects: People building Atuin from source
Read the evidence
v18.11.02026-01-12

Install Rust 1.91 or newer before building this release.

Action requiredAffects: People building Atuin from source
Read the evidence
v18.10.02025-10-21

Install Rust 1.90 or newer before building this release.

Action requiredAffects: People building Atuin from source
Read the evidence
Release history 14
v18.23.02026-09-21

Search the text your past commands printed, not only the commands themselves.

Details

Full-text search over captured command output with `atuin output search` (with JSON and NDJSON output) and an `atuin_output_search` MCP tool; repeated exit-code filters; durations in config accept units; the minimum Rust version for building drops to 1.95.

v18.23.0; building from source needs Rust 1.95.

Improved: Capture the output of the commands you run so you o…Improved: Query history from the command line, for example su…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v18.22.02026-09-09

Keep secrets out of captured command output, with redaction built in.

Details

Captured output redacts secrets, keeps the start and end of very long captures, stores the terminal size, and is set up in a new `[output_capture]` section; the inspector gains an output view; the daemon handles history deletion.

v18.22.0.

Improved: Capture the output of the commands you run so you o…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v18.21.02026-08-31

Run a self-hosted Atuin sync server on MySQL.

Details

The server supports MySQL; history sync uses packfiles with parallel upload and download; agent hooks for opencode; PowerShell highlighting; the daemon socket moves to `$TMPDIR/atuin-$UID/atuin.sock`; `atuin ai init` is removed. Groups v18.20.0 to v18.21.0.

v18.21.0; building from source needs Rust 1.98.

Improved: Sync your shell history between machines, encrypted…Behavior changed: Run a background daemon that starts on its own and…Action required: Generate a shell command or ask a question in plain…Improved: Record the shell commands that coding agents run, t…Action required

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v18.19.02026-08-03

Filter history by shell and see commands syntax-highlighted in the search view.

Details

`--shell` and an interactive shell filter; syntax highlighting in search; bash-preexec is bundled; zsh comments are recorded; extra HTTP headers for sync requests; `atuin update` is a real subcommand. The V1 sync protocol and the `skim` search mode are removed, and TLS moves from rustls to native-tls. Groups v18.18.0 to v18.19.0.

v18.19.0.

Improved: Limit a history search to the current session, dire…Improved: Search your shell history in a full-screen view bou…Action required / inferred: Sync your shell history between machines, encrypted…Behavior changed: Search your shell history in a full-screen view bou…Action required / inferred

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v18.17.12026-07-14

Let your AI tools search your shell history through Atuin's MCP server.

Details

An MCP server exposes history tools with more search filters; command output can be captured and read with the `atuin_output` tool; the AI gets `/model` and a status bar; long commands are shortened from the middle. Groups v18.17.0 and v18.17.1.

v18.17.1; building from source needs Rust 1.97.

Added: Let AI tools search your shell history through Atui…Added: Capture the output of the commands you run so you o…Improved: Generate a shell command or ask a question in plain…Action required

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v18.16.12026-05-12

See a clear banner when login or sync fails because of a wrong encryption key.

Details

A banner explains wrong-key errors at login and sync; `atuin hex` is renamed `atuin pty-proxy`, with `atuin hex` and `ATUIN_HEX_*` variables kept as aliases.

v18.16.1.

Improved: Sync your shell history between machines, encrypted…Behavior changed

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v18.16.02026-04-28

Let Atuin AI edit and write files, with your own context from `TERMINAL.md`.

Details

Atuin AI gains `edit_file` and `write_file` tools with overwrite safety, shell tool timeouts, skills, and user context from `TERMINAL.md`.

v18.16.0; building from source needs Rust 1.95.

Improved: Generate a shell command or ask a question in plain…Action required

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v18.15.22026-04-16

Read and change settings from the command line with `atuin config`.

Details

`atuin config` gets and sets config values; a keybinding deletes all matching commands; mouse support can be turned off; `history tail` follows history live; coding-agent shell usage is tracked through installed hooks; AI sessions can be resumed; trailing whitespace is stripped by default. Groups v18.14.0 to v18.15.2.

v18.15.2.

Added: Read and set Atuin settings from the command line w…Added: Record the shell commands that coding agents run, t…Improved: Search your shell history in a full-screen view bou…Behavior changed: Record each command with its exit code, directory,…Improved: Generate a shell command or ask a question in plain…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v18.13.62026-03-27

Use the Atuin daemon as a supported feature rather than an experiment.

Details

The daemon's experimental label is removed; `atuin search -i` runs as a subcommand on Windows; kv values can be set from stdin. Groups v18.13.4 to v18.13.6.

v18.13.6.

Now stable: Run a background daemon that starts on its own and…Improved: Search your shell history in a full-screen view bou…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v18.13.32026-03-16

Ask Atuin to write a shell command or answer a question with `atuin ai`.

Details

`atuin ai` generates commands and answers questions; the daemon starts on its own and keeps an in-memory search index; `atuin setup` and Atuin Hub sign-in; frequency, recency and frecency scores can be weighted. Groups v18.13.0 to v18.13.3.

v18.13.3; building from source needs Rust 1.94. Atuin AI uses Atuin Hub.

Added: Generate a shell command or ask a question in plain…Added: Run a background daemon that starts on its own and…Improved: Search your shell history in a full-screen view bou…Behavior changed: Generate a shell command or ask a question in plain…Action required

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v18.12.12026-02-11

Define your own keybindings in the search view, including vim motions.

Details

A custom keybinding system for the search TUI with vim motions and media keys; tmux `display-popup` option; ultracompact mode; custom data directory; several state files moved into one SQLite database; the server moved to its own `atuin-server` binary. Groups v18.12.0 and v18.12.1.

v18.12.1; building from source needs Rust 1.93.

Added: Define your own keybindings in the search view, inc…Improved: Search your shell history in a full-screen view bou…Action required / inferred: Sync your shell history between machines, encrypted…Action required

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v18.11.02026-01-12

Turn off the old V1 sync protocol on a self-hosted server.

Details

Servers can disable sync v1 and use Postgres read replicas; `history list` can show session and UUID columns; Intel Mac binaries are no longer built.

v18.11.0; building from source needs Rust 1.91.

Improved: Sync your shell history between machines, encrypted…Action requiredAction required

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v18.10.02025-10-21

Inspect a past command in an interactive view and act on it.

Details

Interactive inspector; import from PowerShell history; search matches are highlighted; `session-preload` filter mode; more accept keys and shell pipelines in command chaining. Groups v18.9.0 and v18.10.0.

v18.10.0; building from source needs Rust 1.90.

Added: Open a past command in an interactive inspector tha…Improved: Import the history your shell already has.Improved: Search your shell history in a full-screen view bou…Action required

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v18.8.02025-08-04
Starting point

Search your whole shell history in a full-screen view bound to Ctrl-R.

Details

State of Atuin at v18.8.0: history stored in SQLite with context per command, a search UI on Ctrl-R and the up arrow, filter modes, statistics, and optional end-to-end encrypted sync.

Install with the install script, a package or `cargo install atuin`; building from source needs Rust 1.88.

Added: Search your shell history in a full-screen view bou…Added: Record each command with its exit code, directory,…Added: Limit a history search to the current session, dire…Added: Query history from the command line, for example su…Added: Sync your shell history between machines, encrypted…Added: See statistics about your history, such as your mos…Added: Import the history your shell already has.

Seeded by @iluxav with Claude Code (canido)

Read the evidence