CMD-WRAPPED : Visualisez vos statistiques d’utilisation de votre terminal

https://github.com/orhun/cmd-wrapped

📌 CMD-WRAPPED est une application en ligne de commande dédiée à l’analyse intelligente de l’historique du terminal. Pensé pour offrir une lecture claire et synthétique des usages quotidiens du shell, cet outil transforme l’historique brut en statistiques exploitables.

cmd-wrapped permet d’explorer l’activité du terminal à travers le temps, en s’appuyant sur les timestamps des commandes exécutées.
L’objectif est simple : comprendre les habitudes, repérer les commandes les plus utilisées et obtenir une vision annuelle ou globale de l’usage du shell.

L’outil prend en charge plusieurs environnements très répandus.
La compatibilité couvre aussi bien les shells classiques que des solutions plus modernes orientées productivité.

Au cœur de cmd-wrapped, quelques fonctionnalités clés ressortent clairement :

• 📊 Statistiques détaillées basées sur l’historique réel des commandes
• 🐚 Support multi-shell : zsh, bash, fish, nushell et atuin
• 📅 Analyse annuelle pour comparer l’usage d’une année à l’autre
• ⚙️ Configuration ciblée selon le shell utilisé
• 🚀 Exécution rapide sans dépendance lourde

L’installation est volontairement flexible.
Elle peut se faire via Cargo pour les environnements Rust, par téléchargement direct du binaire, ou encore via des gestionnaires de paquets comme yay sur Arch Linux ou Nix.

Une fois installé, l’utilisation reste minimale.
Une simple commande affiche les statistiques courantes, tandis qu’un argument supplémentaire permet de cibler une année précise ou un shell spécifique.

cmd-wrapped repose fortement sur la présence d’horodatages dans l’historique.
Sans cette information, les statistiques peuvent apparaître incorrectes ou vides.

Certains shells nécessitent donc une configuration préalable.
Zsh doit avoir l’option EXTENDED_HISTORY active, Bash requiert HISTTIMEFORMAT, et Nushell doit utiliser un stockage d’historique au format SQLite.

Les commandes exécutées avant cette configuration ne peuvent pas être analysées correctement.
Ce point est essentiel pour garantir la fiabilité des résultats affichés.

Enfin, cmd-wrapped est distribué sous licence MIT.
Le projet s’inscrit dans une démarche open source, avec une idée originale saluée au sein de la communauté.

Un outil discret, mais redoutablement efficace pour mieux comprendre ce qui se passe réellement dans un terminal au quotidien.

NB :

❗ Problème rencontré avec cmd-wrapped sur zsh

Lors de l’utilisation de cmd-wrapped avec zsh, toutes les statistiques affichées étaient à 0, malgré un historique de commandes bien présent.

Le problème ne venait pas de l’outil, mais de la configuration de l’historique zsh.

cmd-wrapped repose entièrement sur les timestamps (horodatage) des commandes pour calculer les statistiques par période (année, fréquence, etc.).

Or, par défaut, zsh n’enregistre pas les timestamps dans son fichier d’historique tant que l’option suivante n’est pas activée :

EXTENDED_HISTORY

Sans cette option :

• l’historique contient les commandes
• mais aucune information de date
• donc cmd-wrapped ne peut rien analyser → stats à 0

🛠️ Correction appliquée

1. Activation de l’historique étendu

Dans le fichier ~/.zshrc, ajout de l’option :

setopt EXTENDED_HISTORY

Puis rechargement de la configuration :

source ~/.zshrc

Mais l’activation de EXTENDED_HISTORY n’est pas rétroactive.

• Les commandes exécutées avant l’activation n’ont aucun timestamp.
• Il est donc impossible de reconstruire les statistiques des années passées (ex. 2025).
• Les statistiques seront correctes uniquement à partir du moment où l’option est activée.

✅ Résultat

La configuration est désormais conforme aux attentes de l’outil

cmd-wrapped fonctionne correctement avec zsh

Les statistiques sont fiables pour l’année en cours et les suivantes