Claudine

╭───────────────────────────────────────────────────────────────────╮
│  claudine  │ 1 Projets │ 2 Mémoire │ 3 Config │ 4 Extensions │ 5 Usage │
╰───────────────────────────────────────────────────────────────────╯

Claudine est un outil Rust TUI/CLI pour naviguer et gérer les données locales de Claude Code stockées dans ~/.claude : sessions, mémoire (CLAUDE.md), configuration (settings.json) et extensions (hooks, plugins, serveurs MCP).

Site : https://systm-d.github.io/claudine

---

Fonctionnalités

• TUI interactif — cinq onglets (Projets, Mémoire, Config, Extensions, Usage) ; navigation clavier complète.
• CLI — sous-commandes export, import, homes, update pour les scripts et la CI.
• Auto-mise à jour — claudine update télécharge et installe la dernière release GitHub pour votre plateforme (Linux x86-64, macOS Apple Silicon, Windows x86-64) ; --check signale simplement qu'une version existe. Honore HTTPS_PROXY.
• Multi-home — plusieurs installations Claude côte à côte (~/.claude, ~/.claude-perso, …) ; vue agrégée repliable ou home ciblée.
• Sessions nommées — la liste affiche le titre de la session (renommage ou résumé enregistré par Claude Code) quand il existe, avec l'identifiant court en repère ; à défaut, l'identifiant seul.
• Recherche live — filtre sur nom/chemin/identifiant, puis cherche dans le contenu des sessions au fur et à mesure de la frappe dès 3 caractères (touche / ; Tab force la recherche de contenu même pour une requête plus courte). Les extraits de résultats sont centrés sur le terme trouvé (texte des messages, pas les métadonnées JSON).
• Transcript lisible — la conversation est affichée sans le bruit interne (métadonnées mode, snapshots, pièces jointes…) ; a révèle tout. Les appels d'outils montrent leur argument principal, les résultats un aperçu. Horodatages condensés (2026-07-22 17:24).
• Ménage & corbeille — suppression récupérable des sessions et des projets ; restauration, suppression définitive ou vidage depuis le TUI.
• Export / Import — bundle .tar.gz horodaté avec manifeste ; remap des chemins à l'import ; exclusion automatique des secrets.
• Extensions — lecture des hooks, plugins et serveurs MCP ; édition des hooks, bascule des plugins directement dans le TUI.
• Statistiques d'usage — onglet « Usage » (5) : tokens consommés (entrée / sortie / cache), estimation de coût par famille de modèle et grille d'activité quotidienne façon GitHub (aux couleurs de l'interface). u sur une session affiche sa décomposition détaillée. L'estimation de coût s'appuie sur une table de tarifs Anthropic ; les modèles inconnus sont comptés en tokens mais exclus du coût (signalés par *).

---

Sûreté

• Corbeille récupérable : aucune suppression définitive sans confirmation explicite.
• Écriture atomique : settings.json est écrit via fichier temporaire + rename, jamais à moitié.
• Sauvegarde horodatée : avant chaque modification de settings.json, une copie .bak-<nanos> est créée.
• Garde tar-slip : les entrées d'archive contenant .. ou une racine absolue sont rejetées à l'import.
• Exclusion des secrets à l'export : .credentials.json, security_warnings_state_*, cache/, telemetry/, etc., ne sont jamais inclus.

---

Installation

Cargo (crates.io)

cargo install claudine

Depuis les sources

Rust ≥ 1.85 requis.

git clone https://github.com/systm-d/claudine
cd claudine
cargo install --path crates/claudine

Paquets précompilés

Chaque tag v* déclenche le workflow Release qui publie des artefacts pour les plateformes les plus répandues :

Plateforme	Artefact
Windows (Microsoft)	claudine-windows-x86_64.exe (+ .zip)
macOS Apple Silicon	claudine-macos-aarch64.tar.gz
Linux générique	claudine-linux-x86_64.tar.gz
Debian / Ubuntu	claudine_<version>_amd64.deb
Fedora / RHEL	claudine-<version>.x86_64.rpm
Arch Linux	AUR (source) — yay -S claudine

Les Mac Intel sont couverts par Homebrew, qui compile depuis les sources (pas de binaire Intel pré-compilé).

# Debian / Ubuntu
sudo dpkg -i claudine_*.deb
# Fedora / RHEL
sudo rpm -i claudine-*.rpm

Arch Linux : voir la section AUR ci-dessous (installation depuis les sources via le PKGBUILD, pas de paquet pré-compilé).

Gestionnaires de paquets

Arch Linux — AUR :

yay -S claudine   # ou : paru -S claudine

Chaque release publie aussi un PKGBUILD prêt à l'emploi (packaging/aur/PKGBUILD) pour une installation manuelle depuis les sources :

curl -LO https://github.com/systm-d/claudine/releases/latest/download/PKGBUILD
makepkg -si

macOS — Homebrew :

brew tap systm-d/claudine https://github.com/systm-d/claudine
brew install claudine

Windows — winget (une fois le paquet publié sur winget-pkgs, cf. packaging/winget) :

winget install claudine

Sinon, télécharge claudine-windows-x86_64.exe depuis la release et place-le dans un dossier de ton PATH.

---

Utilisation

Lancer la TUI

claudine

Raccourcis clavier (TUI)

Touche	Action
1 … 5	Projets / Mémoire / Config / Extensions / Usage
Tab	Section suivante
↑ ↓ / j k	Naviguer / défiler
← →	Changer de panneau (vue Browse)
Enter	Ouvrir la session sélectionnée
a	Transcript : afficher/masquer les entrées internes
Espace	Replier / déplier le home courant (vue agrégée)
z	Tout replier / tout déplier (vue agrégée)
/	Rechercher (live nom/chemin/id · contenu dès 3 caractères)
d / Suppr	Envoyer en corbeille : session (Projets) ou projet (Projets)
m	Déplacer la session vers un autre projet
c	Corbeille : restaurer / supprimer définitivement / vider
u	Stats d'usage de la session sélectionnée (onglet Projets)
Esc	Retour (transcript) ou quitter
PgUp / PgDn	Défilement par page
Home / End	Aller au début / à la fin
e	Exporter ~/.claude en .tar.gz
i	Importer un bundle .tar.gz (aperçu puis application)
E	Éditer le fichier de la section dans $EDITOR
h	Homes : vue agrégée (★ Tous) ou un home précis
t	En agrégé : changer le home cible de Mémoire/Config
?	Afficher / masquer l'aide
q / Ctrl-C	Quitter

Extensions : Enter édite les hooks, p (dés)active les plugins. Config : ↑↓ champ · Enter éditer · ←→ option · s enregistrer · r JSON brut.

Sous-commandes CLI

# Exporter la home Claude en bundle
claudine export --out sauvegarde.tar.gz

# Exporter sans l'historique, home spécifique
claudine export --out sauvegarde.tar.gz --no-history --home .claude-perso

# Aperçu d'un import (dry-run)
claudine import sauvegarde.tar.gz --dry-run

# Importer avec remap de chemins
claudine import sauvegarde.tar.gz --map /ancien/chemin=/nouveau/chemin --overwrite

# Lister les homes enregistrées
claudine homes

# Enregistrer une home
claudine homes add ~/.claude-perso --label perso

# Retirer une home
claudine homes remove perso

# Vérifier si une mise à jour est disponible
claudine update --check

# Installer la dernière version (remplace le binaire courant)
claudine update

---

Développement

# Compiler
cargo build --workspace

# Tests
cargo test --workspace

# Linter
cargo clippy --workspace --all-targets -- -D warnings

# Formatage (rustfmt.toml : edition 2024, max_width 100)
cargo fmt

Note : ce projet utilise cargo fmt ; la CI vérifie cargo fmt --check. Exécutez cargo fmt avant chaque commit.

---

Contributing

Voir CONTRIBUTING.md.

---

Licence

Doublement licencié sous MIT OR Apache-2.0, au choix — voir LICENSE-MIT et LICENSE-APACHE.

Copyright © 2026 Kevin Delfour / systm-d.