Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

atuinsh/atuin

Developer Tools

A terminal history and agent-session store for shell users and AI coding agent workflows.

32,515
1,048
Rust
MIT
6 years old

What it does

Atuin replaces the shell's flat history file with a SQLite database. It records each command along with exit code, working directory, hostname and duration, then exposes that data through Ctrl-R and an atuin search command that can filter by exit status, time and command text README.

It also indexes sessions from coding agents such as Claude Code, Codex and OpenCode as threads, which can be searched with atuin threads search and resumed on another machine or in another harness with atuin resume (for example, start in Claude Code locally and continue in Codex over SSH). An optional MCP server lets an agent query the recorded history and threads README.

History and threads can be synced across machines, end-to-end encrypted, through the hosted Atuin Service or a self-hosted sync server; the tool also works fully offline README. Supported shells include zsh, bash, fish, nushell, xonsh and PowerShell.

Quick start

Install with the official installer and restart your shell:

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

After the restart, press Ctrl-R to open the search pane; Enter runs the highlighted command and Tab edits it before running README. The CLI provides the same data:

atuin search --exit 0 --after "yesterday 3pm" make

This lists successful make invocations recorded after 3pm the previous day.

Constraints

  • Sync is opt-in; without it, history and threads stay on the local machine. When enabled, synced content is end-to-end encrypted, but the sync server still has to be available or self-hosted.
  • Thread capture depends on the coding agent being supported; the README lists Claude Code, Codex, OpenCode, Copilot, Grok, Hermes and others, but compatibility for a given harness should be checked.
  • Ctrl-R interception changes familiar shell behavior. HN users noted the extra keystroke and all-session search scope, and workarounds include remapping the up arrow, switching search scope to session or directory, and cycling scopes HN discussion reply reply.
  • The project is MIT-licensed.

HotRepo's take

On the Rust daily list for 2026-11-17, the repository recorded 32,498 stars and 1,047 forks, gaining 37 stars that day while placing 10th on that list. The two HN threads in the record date to 2024 and discuss the SQLite-history concept and "Atuin Wrapped"; the practical complaints there concern Ctrl-R behavior and session-scoped search rather than the project's purpose. The newer agent-thread and MCP features are not covered by those discussions.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

Hacker News

Atuin replaces your existing shell history with a SQLite database
▲ 108 · 10 comments · January 10, 2024
Atuin Wrapped: Your year in shell history
▲ 4 · 0 comments · December 27, 2024

You might also like

  1. nushell/nushellA cross-platform shell that treats command output as structured data for filtering, exploring, and scripting.Rust40,798
  2. google-gemini/gemini-api-cliA Go CLI that lets coding agents and shell scripts call Gemini models, generate media, analyze files, and run managed agents.Go462
  3. nvm-sh/nvmInstall and switch between multiple Node.js versions per shell with a POSIX-compliant shell script.Shell95,766
  4. ratatui/ratatuiA Rust library for building interactive terminal user interfaces, dashboard and console apps.Rust23,291
  5. rorkai/App-Store-Connect-CLIA scriptable command-line client for the App Store Connect API, aimed at teams that automate iOS release chores.Go8,061