SourceSage CLI

Ce que fait cet outil

SourceSage CLI transforme un dépôt de code en un résumé Markdown adapté aux IA. Il extrait les sections du README, les statistiques de fichiers, les métadonnées Git et un récit concis du dépôt dans le fichier .SourceSageAssets/Repository_summary.md. L'outil supporte une sortie --lite pour des résumés compacts, la sélection de la langue (ex: Anglais/Japonais) et un rapport optionnel de différence de tags (déprécié) pour les comparaisons de versions.

Quand l'utiliser

Utilisez SourceSage lorsque vous avez besoin d'une vue d'ensemble rapide et structurée d'un dépôt pour des tâches LLM en aval : intégration d'un modèle à une base de code, préparation de la documentation pour analyse, ou génération d'un résumé compact pour des outils attendant des entrées Markdown. Privilégiez uv run sage à l'intérieur du dépôt ; utilisez --lite pour des passages exploratoires ou pour limiter la consommation de tokens.

Ce qui est inclus

• Scripts : le dépôt contient les points d'entrée CLI et les notes d'utilisation recommandées pour uv run (aucun répertoire de scripts supplémentaire n'a été détecté).
• Références : README et notes CLI dans le dépôt ; aucun dossier references/ séparé n'a été détecté.
• Instructions : déterminez la racine de l'outil, choisissez la commande sage la plus courte pour la tâche (uv run sage, uv run sage --lite, ou uv run --directory <sourcesage-root> sage --repo <target>), puis vérifiez le fichier .SourceSageAssets/Repository_summary.md généré.

Agents compatibles

Cette compétence est adaptée aux agents conscients du code et aux assistants compatibles CLI (ex: agents de type Codex/Copilot ou tout agent capable d'exécuter des commandes shell) qui ont besoin de résumés de dépôts structurés pour amorcer des prompts ou effectuer des analyses.