atuin : retrouvez n'importe quelle commande en 3 secondes

Le problème que vous connaissez

Vous avez lancé une commande Docker la semaine dernière. Elle fonctionnait parfaitement. Mais laquelle exactement ?

Vous appuyez sur Ctrl+R, tapez docker… et vous scrollez. Longtemps. Vous ne trouvez pas. Vous finissez par la retaper de mémoire, avec une erreur de syntaxe.

atuin résout ce problème en 3 secondes.

Vous appuyez sur ↑, tapez docker, et l’interface atuin s’ouvre avec toutes vos commandes Docker. Vous sélectionnez, Entrée, c’est fait.

Ce qu’atuin enregistre (et ce qu’il n’enregistre pas)

Important : les commandes importées

Quand vous installez atuin, il importe votre historique shell existant. Mais ces commandes importées n’ont pas de contexte — atuin ne connaît pas le dossier, la durée ou le code de sortie.

Seules les commandes exécutées après l’installation ont le contexte complet :

• Le dossier où vous avez lancé la commande
• La durée d’exécution
• Le code de sortie (succès/échec)
• La date et l’heure

Voici ce qu’atuin enregistre pour chaque commande exécutée après son installation :

# Exemple de commande avec contexte complet
atuin history list -f "{time}\t{command}\t{directory}\t{duration}\t{exit}" -r false | head -3

2026-01-30 13:56:11     code ~/.config/atuin/config.toml   /home/bob/Projets   109ms   0
2026-01-30 13:55:45     npm run dev                        /home/bob/Projets   13m     130
2026-01-30 13:33:37     docker ps -a                       /home/bob/infra     1s      0

C’est ce contexte qui permet les filtres “par dossier” ou “par machine” — impossibles avec Ctrl+R.

Installez atuin en 2 minutes

Script officiel (recommandé)

1. Lancez le script d’installation

   bash <(curl --proto '=https' --tlsv1.2 -sSf https://setup.atuin.sh)

   Le script détecte votre shell (Bash, Zsh ou Fish) et configure tout automatiquement. Le binaire est installé dans ~/.atuin/bin/.

2. Redémarrez votre shell

   exec $SHELL

3. Importez votre historique existant

   atuin import auto

   Vous verrez quelque chose comme :

   Importing history from zsh
   Found 8347 entries
   Imported 8347 new entries

   Ces commandes importées n’auront pas de contexte (dossier, durée), mais vous pourrez les retrouver.

4. Testez : appuyez sur ↑

   L’interface atuin s’ouvre. Vous êtes prêt.

Homebrew (macOS)

brew install atuin
echo 'eval "$(atuin init zsh)"' >> ~/.zshrc
exec $SHELL
atuin import auto

Cargo (Rust)

cargo install atuin --locked
echo 'eval "$(atuin init bash)"' >> ~/.bashrc  # ou zsh, fish
exec $SHELL
atuin import auto

Pacman (Arch)

sudo pacman -S atuin
echo 'eval "$(atuin init bash)"' >> ~/.bashrc
exec $SHELL
atuin import auto

Si ↑ n'ouvre pas atuin

Vérifiez que le hook est présent :

grep "atuin init" ~/.bashrc ~/.zshrc 2>/dev/null

Si rien ne s’affiche, ajoutez-le manuellement :

echo 'eval "$(atuin init bash)"' >> ~/.bashrc  # ou zsh
exec $SHELL

Votre première recherche

Maintenant qu’atuin est installé, essayons ensemble.

Étape 1 : Appuyez sur ↑ (flèche haut).

L’interface atuin s’ouvre. Vous voyez vos dernières commandes.

Étape 2 : Tapez git.

Sans appuyer sur Entrée. Juste les lettres g, i, t.

Regardez : la liste se filtre instantanément. Vous ne voyez plus que les commandes contenant “git” : git status, git push, git log --oneline, etc.

Étape 3 : Naviguez avec les flèches, puis :

• Entrée → exécute la commande immédiatement
• Tab → insère la commande dans votre prompt (pour la modifier avant de l’exécuter)

C’est tout. Vous savez utiliser atuin.

Tab ou Entrée ?

Utilisez Tab quand vous voulez modifier la commande avant de la lancer. Par exemple, vous trouvez docker run nginx:1.24 mais vous voulez nginx:1.25. Tab, modifiez, Entrée.

Utilisez Entrée quand la commande est exactement ce que vous voulez.

Les 4 situations que vous rencontrerez

Situation 1 : “Je cherche une commande Docker”

Vous vous souvenez vaguement d’une commande Docker, mais pas exactement.

Ce que vous faites : ↑, tapez docker, scrollez.

La recherche est “fuzzy” : docker trouve aussi docker-compose, Dockerfile, etc. C’est ce que vous voulez la plupart du temps.

Situation 2 : “Je veux exactement docker ps -a”

Vous ne voulez pas docker-compose ps, vous voulez exactement docker ps -a.

Ce que vous faites : ↑, tapez 'docker ps -a' (avec les guillemets simples).

Les guillemets simples désactivent la recherche fuzzy. Vous obtenez uniquement les correspondances exactes.

Situation 3 : “Je veux les commandes de ce projet”

Vous êtes dans ~/projects/api et vous voulez voir uniquement les commandes que vous avez lancées ici, pas celles des autres projets.

Ce que vous faites :

1. ↑ pour ouvrir atuin
2. Appuyez sur Ctrl+R plusieurs fois jusqu’à voir “directory” dans l’en-tête
3. Tapez votre recherche

Le filtre “directory” limite aux commandes exécutées dans le répertoire courant.

Uniquement pour les commandes récentes

Ce filtre ne fonctionne que pour les commandes exécutées après l’installation d’atuin. Les commandes importées n’ont pas l’info du dossier.

Situation 4 : “Je veux les commandes de ce serveur”

Vous êtes connecté en SSH sur prod-server et vous voulez voir uniquement les commandes lancées sur cette machine (pas celles de votre laptop).

Ce que vous faites :

1. ↑ pour ouvrir atuin
2. Appuyez sur Ctrl+R plusieurs fois jusqu’à voir “host”
3. Tapez votre recherche

Le filtre “host” limite aux commandes de la machine actuelle.

Les filtres d’atuin

Quand vous appuyez sur Ctrl+R dans l’interface atuin, vous basculez entre ces modes :

Filtre	Ce qu’il montre	Quand l’utiliser
global	Tout votre historique	Recherche générale
host	Cette machine uniquement	Commandes spécifiques au serveur
session	Ce terminal uniquement	Ce que vous faites en ce moment
directory	Ce dossier uniquement	Commandes de ce projet
workspace	Ce repo Git	Si vous êtes dans un sous-dossier d’un repo

Glissez pour voir

Pour activer le filtre workspace, ajoutez dans votre config :

~/.config/atuin/config.toml

workspaces = true

Syntaxe de recherche

La recherche utilise la syntaxe fzf :

Ce que vous tapez	Ce que ça fait	Exemple
mot	Recherche fuzzy (par défaut)	docker trouve docker, docker-compose
'mot exact'	Correspondance exacte	'docker ps' trouve uniquement docker ps
^debut	Commence par	^git trouve git log, git status
fin$	Se termine par	.json$ trouve cat config.json
!mot	Exclut un mot	docker !compose trouve docker sans compose

Glissez pour voir

Vous pouvez combiner avec | (OU) :

^git log$ | ^git status$

Configuration recommandée

Créez ou éditez ~/.config/atuin/config.toml :

~/.config/atuin/config.toml

## Style d'affichage
## "compact" = 1 ligne par commande (défaut)
## "full" = 2 lignes (commande + contexte)
## "auto" = adaptatif selon la taille du terminal
style = "full"

## Mode de recherche : "fuzzy" (recommandé), "prefix", "fulltext", "skim"
search_mode = "fuzzy"

## Filtre par défaut : "global", "host", "session", "directory"
filter_mode = "global"

## Activer le filtre par repo Git
workspaces = true

## Entrée = exécute immédiatement (true) ou insère pour édition (false)
enter_accept = true

## Afficher la preview des commandes longues
show_preview = true

## Détection automatique des secrets (activé par défaut, ne pas désactiver)
secrets_filter = true

[sync]
## Sync v2 (plus rapide)
records = true

Les deux styles d’affichage

Style compact (défaut) — une ligne par commande :

docker ps -a
npm run dev
git push origin main

Style full — deux lignes avec le contexte :

docker ps -a
~/projects/api • 1s • exit 0 • 2026-01-30 14:23

npm run dev
~/projects/api • 13m • exit 130 • 2026-01-30 13:33

Le style full est plus informatif mais prend plus de place. Choisissez selon votre préférence.

Synchronisation entre machines (optionnel)

Cette section est 100% optionnelle

atuin fonctionne parfaitement en local sans compte ni synchronisation. Lisez cette section uniquement si vous utilisez plusieurs machines et voulez retrouver vos commandes partout.

Pourquoi synchroniser ?

Vous avez un laptop et un serveur. Vous lancez une commande sur le serveur, puis vous voulez la retrouver depuis votre laptop. Sans sync, impossible.

Avec la sync atuin, votre historique est chiffré localement avant d’être envoyé. Même les administrateurs du serveur ne peuvent pas lire vos commandes.

Comment activer la sync

1. Sur votre première machine, créez un compte

   atuin register -u votre_pseudo -e votre@email.com

   Entrez un mot de passe quand demandé. Une clé de chiffrement est générée automatiquement.

2. Sauvegardez votre clé (important)

   atuin key

   Copiez cette clé dans un gestionnaire de mots de passe. C’est elle qui permet de déchiffrer votre historique. Si vous la perdez, vos commandes synchronisées sont irrécupérables.

3. Sur une autre machine, connectez-vous

   Installez atuin, puis :

   atuin login -u votre_pseudo
   atuin sync

   Vos commandes des deux machines sont maintenant synchronisées.

Ne perdez pas votre clé

Le fichier ~/.local/share/atuin/key est indispensable. Sauvegardez-le dès maintenant avec atuin key.

Fréquence de synchronisation

Par défaut, atuin synchronise toutes les heures. Vous pouvez ajuster :

~/.config/atuin/config.toml

## Sync toutes les 10 minutes
sync_frequency = "10m"

## Sync après chaque commande (peut être rate-limited par le serveur)
sync_frequency = "0"

## Désactiver la sync automatique
auto_sync = false

Fichiers et emplacements

~/.local/share/atuin/
├── history.db    # Base SQLite (votre historique)
├── key           # Clé de chiffrement (sync uniquement)
└── session       # Token de session (sync uniquement)

~/.config/atuin/
└── config.toml   # Configuration

Commandes utiles

# Vérifier l'installation
atuin --version

# Diagnostic complet
atuin doctor

# Voir les dernières commandes
atuin history list -r false | head -10

# Statistiques d'utilisation
atuin stats

# Forcer une synchronisation
atuin sync

Dépannage

atuin ne s’ouvre pas avec ↑ :

# Vérifiez que le hook est présent
grep "atuin init" ~/.bashrc ~/.zshrc 2>/dev/null

Si rien ne s’affiche, ajoutez le hook manuellement (voir section Installation).

Les filtres directory/host ne fonctionnent pas :

C’est normal pour les commandes importées. Ces filtres ne fonctionnent que pour les commandes exécutées après l’installation d’atuin.

Vérifier que tout fonctionne :

atuin doctor

Ce qu’il faut retenir

1. ↑ ouvre atuin
2. Tapez des lettres pour filtrer (recherche fuzzy)
3. Entrée exécute, Tab insère pour modifier
4. Ctrl+R (plusieurs fois) change le filtre (global → host → directory)
5. Les filtres contextuels (directory, host) ne fonctionnent que pour les commandes exécutées après l’installation
6. La sync est optionnelle — atuin fonctionne très bien en local

D’autres outils

eza : ls amélioré Affichez vos fichiers avec couleurs, icônes et infos Git

broot : exploration de fichiers Naviguez dans vos dossiers avec une interface visuelle

glances : surveillance système Surveillez les ressources système en temps réel

Ressources

• Documentation officielle — Configuration complète
• Configuration reference — Toutes les options
• GitHub atuin — Code source et issues

×

📖 Voir la documentation →