osfeed.dev
Projects/atuinsh / atuin

Atuin

Searchable, synced shell history with an AI command helper

by@atuinsh·Runs on Linux · macOS · Windows
Get it on GitHub
Unclaimed

Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for v18.24.8 (2026-11-13), so it may lag behind newer releases.

Are you @atuinsh?Claim it, and your coding agent keeps it current with each release
v18.24.8 · 17 things you can do 32.5k stars 32 changes to know before upgrading

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

This page covers Atuin up to v18.24.8. GitHub has v18.25.0 (), not published here yet. Maintainer? Publish it with your agent.

What you can do with Atuin

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

Present at v18.8.0
Share
Wrong?

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

Present at v18.8.0
Share
Wrong?

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

Present at v18.8.0
Good to know

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

Share
Wrong?
Show all 17

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

Since v18.13.3
Share
Wrong?

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

Since v18.15.2
Share
Wrong?

Capture, search and sync coding-agent conversations, then resume, fork or continue them in another agent.

Since v18.24.1
Good to know

Opt-in with `atuin threads enable`; needs the daemon and installed agents for resume. Images are omitted, tool input/output is clipped to 64 KiB, and search excludes tool output. Cross-agent continuation drops reasoning.

Share
Wrong?

Change to the directory where a selected history command ran, or place that directory-change command on your command line.

Since v18.24.1
Good to know

Needs a known shell and a safe absolute recorded directory; Atuin does not check whether the directory still exists.

Share
Wrong?

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

ExperimentalSince v18.13.3
Good to know

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

Share
Wrong?

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

ExperimentalSince v18.17.1
Share
Wrong?

Before you upgrade Atuin

Newest first
v18.24.8

Review relative path settings and use absolute paths if they must keep pointing to their old locations. Relative paths now resolve beside `config.toml`, including paths supplied through `ATUIN_*` variables.

Action requiredInferredAffects: Configurations whose paths relied on the process's working directory
Read the evidence
Share
Wrong?
Show 29 older
v18.24.1

Before moving `config.toml`, review `permissions.ai.toml`, `skills` and `TERMINAL.md`: they become global when `~/.atuin/config.toml` exists. Move home-scoped items into project subdirectories and merge duplicate legacy AI files as needed.

Action requiredAffects: Users moving legacy config into `~/.atuin` with existing AI files there
Read the evidence
Share
Wrong?
Atuin release history 16
v18.24.8
with v18.24.2, v18.24.3, v18.24.4, v18.24.5, v18.24.6

Capture and resume conversations from more coding agents, including Copilot, Grok Build, Kiro and Hermes.

Details

Thread capture and resume add agent integrations, while history search gains Jujutsu filtering and configurable shell bindings. Configuration path resolution and server precedence change, and Atuin AI stops loading TERMINAL.md.

Also: Jujutsu workspace filters, macOS daemon management, setup choices and sync fixes; upgrade notes cover relative paths, server overrides, Docker certificates and removal of TERMINAL.md context.

v18.24.8 release binaries for Linux, macOS and Windows; source builds require Rust 1.95 and a C++ toolchain for Luau. Thread capture remains opt-in and needs the daemon; resuming needs the relevant agent.

Improved: Capture, search and sync coding-agent conversations…Now works: Capture, search and sync coding-agent conversations…Behavior changed: Capture, search and sync coding-agent conversations…Action required: Generate a shell command or ask a question in plain…Action required / inferred: Read and set Atuin settings from the command line w…Behavior changed: Sync your shell history between machines, encrypted…Action required: Sync your shell history between machines, encrypted…Now works: Sync your shell history between machines, encrypted…Improved: Sync your shell history between machines, encrypted…Behavior changed: Run a background daemon that starts on its own and…Action required: Run a background daemon that starts on its own and…Now works: Capture the output of the commands you run so you o…Behavior changed: Capture the output of the commands you run so you o…Improved: Record each command with its exit code, directory,…Now works: Record each command with its exit code, directory,…Improved: Limit a history search to the current session, dire…Now works / inferred: Search your shell history in a full-screen view bou…Behavior changed: Search your shell history in a full-screen view bou…Improved: Define your own keybindings in the search view, inc…Improved: Let AI tools search your shell history through Atui…Action required: Let AI tools search your shell history through Atui…Improved: Record the shell commands that coding agents run, t…Now works: Record the shell commands that coding agents run, t…Improved: Read and set Atuin settings from the command line w…Action required / inferred

Seeded by @iluxav with Codex

Read the evidence
v18.24.1
with v18.24.0

Resume a captured coding-agent conversation on another machine or continue it in another agent.

Details

`atuin threads enable` opts into encrypted conversation capture and sync, and `atuin resume` opens a picker with resume, fork and continuation choices. This release also enables workspace filtering by default and introduces `ATUIN_HOME` alongside legacy-location fallback.

Also: Jump to a past command's directory, filter captured output, configure MCP clients, and keep existing installs on legacy paths while new installs use ~/.atuin.

v18.24.1, including v18.24.0; release binaries or source builds with Rust 1.95. Thread capture is opt-in and requires the daemon; resuming requires an installed compatible agent.

Added: Capture, search and sync coding-agent conversations…Improved: Let AI tools search your shell history through Atui…Added: Change to the directory where a selected history co…Behavior changed: Limit a history search to the current session, dire…Now works / inferred: Query history from the command line, for example su…Improved: Capture the output of the commands you run so you o…Now works: Capture the output of the commands you run so you o…Improved: Read and set Atuin settings from the command line w…Behavior changed: Read and set Atuin settings from the command line w…Action required: Generate a shell command or ask a question in plain…Action required: Run a background daemon that starts on its own and…Action required / inferred: Run a background daemon that starts on its own and…Now works: Record each command with its exit code, directory,…Improved: Sync your shell history between machines, encrypted…

Seeded by @iluxav with Codex

Read the evidence
v18.23.0

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

Read the evidence
v18.22.0

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

Read the evidence
v18.21.0

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

Read the evidence
v18.19.0

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

Read the evidence
v18.17.1

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

Read the evidence
v18.16.1

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

Read the evidence
v18.16.0

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

Read the evidence
v18.15.2

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

Read the evidence
v18.13.6

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

Read the evidence
v18.13.3

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

Read the evidence
v18.12.1

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

Read the evidence
v18.11.0

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

Read the evidence
v18.10.0

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

Read the evidence
v18.8.0
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

Read the evidence

Share

LinkedIn takes the link and its card only; write your text there.

X LinkedIn Reddit Hacker News Bluesky