Michelle Tilley 4475e17c00 fix: Atuin hangs when attempting to spawn daemon from Ctrl+R invocation (#3502)
This PR fixes a shell hang when daemon autostart happens from the
interactive search widget.

The bash/zsh/fish integrations run `atuin search -i` under command
substitution and swap stdout/stderr so the TUI can draw to the terminal
while the selected command is captured:

```sh
3>&1 1>&2 2>&3
```

This leaves fd 3 open in the atuin search process. If search autostarts
the daemon, the spawned long-running `atuin daemon start --daemonize`
inherits fd 3, the command-substitution pipe, so the shell keeps waiting
for EOF until the daemon is killed.

The fix: close fd 3 after the swap in the non-tmux bash/zsh/fish paths:

```sh
3>&1 1>&2 2>&3 3>&-
```

Tested on zsh; I still need to confirm for bash and fish. Near as I can
tell, the other shell integrations don't need this change.

Fixes #3499
2026-05-27 14:42:50 -07:00
2021-04-14 17:40:50 +00:00
2021-05-14 08:31:15 +01:00
2022-03-17 21:43:54 +00:00
2023-03-01 19:51:31 +00:00
2021-05-10 21:28:07 +01:00
2023-09-11 09:26:05 +01:00
2025-09-26 10:46:49 -07:00
2026-04-21 02:34:35 +01:00
2021-02-14 16:22:25 +00:00

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

magical shell history


English | 简体中文

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 Shells

  • zsh
  • bash
  • fish
  • nushell
  • xonsh
  • powershell (tier 2 support)

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.

Security

If you find any security issues, we'd appreciate it if you could alert ellie@atuin.sh

Related projects

Please open a PR for any others!

Contributors

Made with contrib.rocks.

S
Description
Magical shell history
Readme MIT 64 MiB
Languages
Rust 95.3%
Shell 3%
TypeScript 0.6%
PowerShell 0.5%
Nix 0.2%
Other 0.3%