Atuin
Searchable, synced shell history with an AI command helper
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.
Thanks. Marked useful.
Thanks. The report went to osfeed, and the line gets checked against the repository.
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
Record each command with its exit code, directory, host, session and duration in a SQLite database.
1 other tool for: See how long commands takeGood to know
Your old history file is kept; Atuin keeps its own database alongside it.
Wrong?
Limit a history search to the current session, directory or host, or search everything.
Wrong?
Query history from the command line, for example successful `make` runs after 3pm yesterday.
Wrong?
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.
Wrong?
See statistics about your history, such as your most used commands.
Wrong?
Import the history your shell already has.
Wrong?
Open a past command in an interactive inspector that shows its details.
Wrong?
Show all 17
Define your own keybindings in the search view, including vim motions and media keys.
1 other tool for: Use Vim key bindingsWrong?
Run a background daemon that starts on its own and keeps a fast in-memory search index.
Wrong?
Read and set Atuin settings from the command line with `atuin config`.
Wrong?
Record the shell commands that coding agents run, through hooks Atuin installs.
Wrong?
Let AI tools search your shell history through Atuin's MCP server.
Wrong?
Capture, search and sync coding-agent conversations, then resume, fork or continue them in another agent.
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.
Wrong?
Change to the directory where a selected history command ran, or place that directory-change command on your command line.
Good to know
Needs a known shell and a safe absolute recorded directory; Atuin does not check whether the directory still exists.
Wrong?
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.
Wrong?
Capture the output of the commands you run so you or your tools can read it later.
Wrong?
Before you upgrade Atuin
Newest first`Enter` in the resume picker always resumes, regardless of `enter_accept`; use `Tab` to edit the command. Thread JSON and `atuin info` now identify the recording host.
Read the evidence
Wrong?
Stop relying on `TERMINAL.md` for automatic AI context: it is no longer read, and `/reload` is removed. No automatic replacement is stated; skills remain available.
Read the evidence
Wrong?
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.
Read the evidence
Wrong?
Show 29 older
Nonempty `ATUIN_*` server variables now override `server.toml`. Empty values count as unset; Kubernetes-style `ATUIN_PORT=tcp://...` is ignored with a warning.
Read the evidence
Wrong?
Replace the original v18.24.2 Docker image with `18.24.2-1` or a later patched release: its stale CA certificate bundle includes vulnerable certificates.
Wrong?
On a graphical macOS login, autostart uses a launchd agent listed in Login Items. Disabling it there leaves Atuin running without the daemon; setting `ATUIN_HOME` or `ATUIN_CONFIG_DIR` keeps direct process startup.
Read the evidence
Wrong?
Run `atuin daemon restart` after changing environment variables used by config paths or agent session locations: the launchd agent retains values from when it was installed.
Read the evidence
Wrong?
The PTY proxy no longer starts automatically on Linux virtual consoles, allowing programs such as `chvt`, `setfont` and `startx` direct console access; manual `atuin pty-proxy` remains available.
Read the evidence
Wrong?
Search shows a one-time note after upgrades that supply one. The first key dismisses it and still performs its normal action; set `show_whats_new = false` to disable these notes.
Read the evidence
Wrong?
Remove unsupported arguments from MCP calls: tools now reject unknown arguments rather than ignoring them. Bad-argument responses include the expected input schema.
Wrong?
Source builds that compile the new Luau configuration support need a C++ toolchain; musl cross-builds need one targeting musl.
Read the evidence
Wrong?
`workspaces` now defaults to `true`, making workspace filtering available for commands across a Git repository tree. Set it to `false` to disable it.
Read the evidence
Wrong?
Config now defaults to `~/.atuin/config.toml` and data to `~/.atuin/data`. Absolute `ATUIN_HOME` selects another root; with it unset, existing legacy locations are still used when the new locations lack the files.
Read the evidence
Wrong?
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.
Read the evidence
Wrong?
Set an explicit `daemon.socket_path` in each profile to avoid connecting to a different profile's daemon.
Read the evidence
Wrong?
Restart the daemon after upgrading so its build matches the client. With autostart enabled, Atuin replaces a daemon from another build automatically.
Wrong?
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.
Read the evidence
Wrong?
Remove `atuin ai init` from your shell config; the command is gone and `atuin init` now sets up Atuin AI.
Read the evidence
Wrong?
Install Rust 1.98 or newer before building this release.
Read the evidence
Wrong?
The V1 sync protocol is removed; switch to sync v2 by setting `records = true` in the `[sync]` config before upgrading.
Read the evidence
Wrong?
The `skim` search mode is removed; Atuin falls back to `fuzzy` and shows a warning. Set `search_mode = "daemon-fuzzy"` instead.
Read the evidence
Wrong?
TLS now uses native-tls instead of rustls, so builds need the system TLS library (OpenSSL on most Linux systems).
Read the evidence
Wrong?
Install Rust 1.97 or newer before building this release.
Read the evidence
Wrong?
`atuin hex` is now `atuin pty-proxy` and `ATUIN_PTY_PROXY_*` replaces `ATUIN_HEX_*`; the old names still work.
Read the evidence
Wrong?
Install Rust 1.95 or newer before building this release.
Read the evidence
Wrong?
Trailing whitespace is now stripped from recorded commands by default (`strip_trailing_whitespace`).
Read the evidence
Wrong?
`atuin init` now also sets up Atuin AI; the docs explain how to turn it off.
Read the evidence
Wrong?
Install Rust 1.94 or newer before building this release.
Read the evidence
Wrong?
The server is now a separate `atuin-server` binary; install it and run that instead of the server built into `atuin`.
Read the evidence
Wrong?
Install Rust 1.93 or newer before building this release.
Read the evidence
Wrong?
No x86_64 macOS binaries are built from this release on; build from source or use another install method.
Read the evidence
Wrong?
Install Rust 1.91 or newer before building this release.
Read the evidence
Wrong?
Atuin release history 16
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.
Seeded by @iluxav with Codex
Read the evidence
- atuinsh/atuin/blob/v18.24.8/docs/docs/ai/threads.md
- atuinsh/atuin/releases/tag/v18.24.3
- atuinsh/atuin/releases/tag/v18.24.5
- atuinsh/atuin/releases/tag/v18.24.4
- atuinsh/atuin/blob/v18.24.8/docs/docs/ai/slash-commands.md
- atuinsh/atuin/blob/v18.24.8/docs/docs/configuration/config.md
- atuinsh/atuin/releases/tag/v18.24.2
- atuinsh/atuin/blob/v18.24.8/docs/docs/self-hosting/server-setup.md
- atuinsh/atuin/releases/tag/v18.24.6
- atuinsh/atuin/blob/v18.24.8/docs/docs/reference/output.md
- atuinsh/atuin/blob/v18.24.8/docs/docs/reference/pty-proxy.md
- atuinsh/atuin/blob/v18.24.8/crates/atuin/src/shell/bash_preexec.rs
- atuinsh/atuin/blob/v18.24.8/crates/atuin-client/src/database.rs
- atuinsh/atuin/blob/v18.24.8/docs/docs/configuration/advanced-key-binding.md
- atuinsh/atuin/blob/v18.24.8/docs/docs/ai/mcp.md
- atuinsh/atuin/blob/v18.24.8/docs/docs/guide/agent-hooks.md
- atuinsh/atuin/blob/v18.24.8/crates/atuin/src/command/client/setup.rs
- atuinsh/atuin/blob/v18.24.8/Cargo.toml
- atuinsh/atuin/blob/v18.24.8/.github/build-setup.yml
- atuinsh/atuin/releases/tag/v18.24.8
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.
Seeded by @iluxav with Codex
Read the evidence
- atuinsh/atuin/blob/v18.24.1/docs/docs/ai/threads.md
- atuinsh/atuin/releases/tag/v18.24.1
- atuinsh/atuin/blob/v18.24.1/docs/docs/ai/mcp.md
- atuinsh/atuin/blob/v18.24.1/docs/docs/configuration/advanced-key-binding.md
- atuinsh/atuin/blob/v18.24.1/crates/atuin-client/config.toml
- atuinsh/atuin/releases/tag/v18.24.0
- atuinsh/atuin/blob/v18.24.1/crates/atuin/src/command/client/search.rs
- atuinsh/atuin/blob/v18.24.1/docs/docs/guide/excluding-commands.md
- atuinsh/atuin/blob/v18.24.1/docs/docs/configuration/config.md
- atuinsh/atuin/blob/v18.24.1/docs/docs/reference/config.md
- atuinsh/atuin/blob/v18.24.1/crates/atuin-daemon/src/grpc/versioning.rs
- atuinsh/atuin/blob/v18.24.1/docs/docs/reference/account.md
- atuinsh/atuin/blob/v18.24.1/docs/docs/self-hosting/server-setup.md
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.
Seeded by @iluxav with Claude Code
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.
Seeded by @iluxav with Claude Code
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.
Seeded by @iluxav with Claude Code
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.
Seeded by @iluxav with Claude Code
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.
Seeded by @iluxav with Claude Code
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.
Seeded by @iluxav with Claude Code
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.
Seeded by @iluxav with Claude Code
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.
Seeded by @iluxav with Claude Code
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.
Seeded by @iluxav with Claude Code
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.
Seeded by @iluxav with Claude Code
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.
Seeded by @iluxav with Claude Code
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.
Seeded by @iluxav with Claude Code
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.
Seeded by @iluxav with Claude Code
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.
Seeded by @iluxav with Claude Code