# Atuin
> Magical shell history with sync, search, and statistics

## Summary
A shell history replacement backed by SQLite. Provides full-text search, encrypted sync across machines, and rich context (exit code, duration, cwd) for every command.

## Capabilities
- Full-text search through shell history
- Encrypted sync across multiple machines
- Stores context: exit code, duration, working directory, hostname
- Statistics and insights about command usage

## When to Use
- Want to search shell history more effectively than ctrl+r
- Need to sync shell history across multiple machines
- Want analytics on your command-line habits

## When NOT to Use
- Security-sensitive environments where history sync is a concern
- Prefer minimal shell configuration

## Key Flags
- `search`: Interactively search through shell history with full-text matching
- `import`: Import history from existing shell history files (bash, zsh, fish)
- `stats`: Show statistics and insights about command usage patterns
- `sync`: Sync shell history with the remote encrypted server

## Usage Patterns
### Search history interactively
```
atuin search -i
```
Opens interactive full-text search through all history

### View shell statistics
```
atuin stats
```
Shows statistics about your command usage

## Installation
- **homebrew**: `brew install atuin`
- **cargo**: `cargo install atuin`
- **pacman**: `sudo pacman -S atuin`

---
Source: https://littlescripts.sh/tools/atuin
