Shell Sage

La fonction principale joue le rôle de générateur de commandes shell : elle transforme une phrase en commande fonctionnelle. Tapez shellsage ask "find large files over 1GB" et il renvoie quelque chose comme find / -type f -size +1G -exec ls -lh {} \;. Vous n'avez pas à retenir la syntaxe exacte des combinaisons de find, grep ou awk, et c'est ce qui rend cet assistant IA pour CLI utile à ceux qui utilisent le terminal sans y vivre.

Quand une commande échoue, Shell Sage lit l'erreur, l'explique et propose un correctif. Il repère les problèmes courants comme les chemins erronés ou les options mal écrites et indique la cause probable plutôt que de vous laisser deviner. Le projet le présente comme l'une de ses deux capacités phares, avec la génération de commandes.

Shell Sage vérifie les commandes avant de les lancer et signale celles qui pourraient faire des dégâts. Une demande pour supprimer un chemin absolu, par exemple, reçoit un avertissement et une alternative plus sûre comme rm -rf ./important-folder. Les commandes ne s'exécutent qu'après votre confirmation, donc vous gardez la main sur tout ce qui est destructeur.

L'outil tourne avec un modèle local ou un modèle cloud, et vous choisissez lequel à la configuration. Le mode local utilise Ollama pour tout garder sur votre machine, ce qui convient aux travaux privés ou sensibles. Le mode cloud se connecte à Groq, OpenAI, Anthropic, Fireworks, OpenRouter ou DeepSeek pour des réponses plus rapides, et l'auteur précise que la vitesse et la qualité varient selon le fournisseur.

La commande shellsage setup vous guide au premier lancement. Elle demande si vous préférez le mode local ou le mode API, puis vous laisse choisir un modèle. Parmi les options locales par défaut figurent llama3:8b-instruct-q4_1, mistral:7b-instruct-v0.3 et phi3:mini-128k-instruct, et les utilisateurs de l'API choisissent un fournisseur et collent une clé.

Une fois configuré, vous pouvez changer de mode ou de modèle sans rien réinstaller. shellsage config --mode api vous fait passer à un fournisseur cloud et shellsage config --mode local --model pointe l'outil vers un autre modèle local. La même commande gère aussi le changement interactif si vous préférez choisir dans une liste.

Shell Sage prend en charge six fournisseurs cloud d'emblée et ne vous enferme pas dans les modèles affichés par l'assistant. Vous pouvez définir n'importe quel modèle proposé par votre fournisseur en modifiant la valeur API_MODEL dans le fichier .env, ce qui garde cet outil CLI open source à jour au fil des nouveautés.