Reading the repo

Opening the box…

Assembly instructions

atuinsh/atuin

✨ Making your shell magical

Rust#bash#fish#history#rust

Difficulty: Easy
Time: about 5 min
Stars: ★ 32,205
Activity: Updated this month
License: MIT
Open issues: 448
Got it running: Be the first
Looked up: 2 h ago

Saved setup from 2 h ago

Start here

Website ↗atuin.shThe project's own site.Docs ↗docs.atuin.shLinked from the README.In the browser ↗Open in GitHub CodespacesThe repo ships a dev container, so nothing to install.

Setup script in the repo

The maintainers included install.sh. Run it from the cloned folder after reading it.

bash install.sh

Will it work on my device?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Supported devices from the README: Supported platforms

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

Checking for

Download for macOS

18.24.5 · 11/4/2026 ↗

atuin-aarch64-apple-darwin.tar.gz

tar.gz · Apple Silicon · 17.0 MB · 344 downloads · best match

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/atuinsh/atuin/releases/download/v18.24.5/atuin-aarch64-apple-darwin.tar.gz"
tar -xzf "atuin-aarch64-apple-darwin.tar.gz"

Other macOS downloads (3)

atuin-server-aarch64-apple-darwin.tar.gz

tar.gz · Apple Silicon · 5.1 MB · 7 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/atuinsh/atuin/releases/download/v18.24.5/atuin-server-aarch64-apple-darwin.tar.gz"
tar -xzf "atuin-server-aarch64-apple-darwin.tar.gz"

atuin-server-x86_64-apple-darwin.tar.gz

tar.gz · Intel · 5.4 MB · 8 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/atuinsh/atuin/releases/download/v18.24.5/atuin-server-x86_64-apple-darwin.tar.gz"
tar -xzf "atuin-server-x86_64-apple-darwin.tar.gz"

atuin-x86_64-apple-darwin.tar.gz

tar.gz · Intel · 18.5 MB · 29 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/atuinsh/atuin/releases/download/v18.24.5/atuin-x86_64-apple-darwin.tar.gz"
tar -xzf "atuin-x86_64-apple-darwin.tar.gz"

Install with a package manager

install script

curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh

Pipes a remote script into your shell. Read it before running.

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

Claude reads the 12 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Rust 1.98.0runtime

Share this manual

Good to know

Cargo workspace — pick a crate with cargo run -p <name>.
Dockerfile available (base image: lukemathwalker/cargo-chef:latest-rust-slim-bookworm@sha256:b4b459d305bee99c8f8200212c46276108af90b0501386e1339336c2e03c81a2).
Dev Container config found — you can open it in VS Code Dev Containers or GitHub Codespaces for a zero-setup environment.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: crates/atuin-ai/Cargo.toml, crates/atuin-client/Cargo.toml, crates/atuin-common/Cargo.toml, crates/atuin-daemon/Cargo.toml and 11 more

Files we read (12)

.devcontainer/devcontainer.json

.github/workflows/beta-release.yml

.github/workflows/devcontainer.yaml

.github/workflows/docker.yaml

.github/workflows/docs-main.yml

.github/workflows/docs-release.yml

.github/workflows/release.yml

CONTRIBUTING.md

Cargo.toml

Dockerfile

README.md

rust-toolchain.toml

Branch main · 1,055 files in the repo