Skip to content
/ he_CLI Public

Un outil CLI puissant pour gérer vos projets Git et GitHub avec simplicité. Créez des repos, synchronisez votre code, gérez vos commits et créez des backups en une seule commande !

Notifications You must be signed in to change notification settings

Lelio88/he_CLI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 HE CLI

Un outil CLI puissant pour gérer vos projets Git et GitHub avec simplicité. Créez des repos, synchronisez votre code, gérez vos commits, créez des backups et générez de la documentation automatiquement !

Version License PowerShell


📑 Table des matières


✨ Fonctionnalités

  • Création de repos GitHub en une commande (avec GitHub Pages optionnel)
  • Synchronisation automatique (commit + pull + push)
  • Génération de README automatique avec IA (Ollama)
  • Gestion de l'historique Git (rollback, logs)
  • Backups automatiques du projet
  • Maintenance système complète (Windows/Linux/macOS)
  • Installation automatique des dépendances
  • Cross-platform (Windows, Linux, macOS)

📦 Prérequis

Obligatoires

  • Git : Télécharger Git
  • PowerShell Core (pwsh) : Requis pour Linux/macOS
    • Linux : Installé automatiquement lors de l'installation
    • macOS : brew install --cask powershell

Optionnels (installés automatiquement)

  • GitHub CLI : Installé lors de la première utilisation de createrepo
  • Python 3.7+ : Nécessaire pour he readme (installation guidée)
  • Ollama : Nécessaire pour he readme (installation guidée)

⚡ Installation

Windows

Option 1 : Installation rapide (une ligne)

irm https://raw.githubusercontent.com/Lelio88/he_CLI/main/install.ps1 | iex

Option 2 : Installation manuelle

# Télécharger et exécuter
curl -O https://raw.githubusercontent.com/Lelio88/he_CLI/main/install.bat
.\install.bat

Chemin d'installation : %USERPROFILE%\he-tools


Linux/macOS

Option 1 : Installation rapide (une ligne)

curl -fsSL https://raw.githubusercontent.com/Lelio88/he_CLI/main/install. sh | bash

Option 2 : Installation manuelle

# Télécharger et exécuter
curl -O https://raw.githubusercontent.com/Lelio88/he_CLI/main/install.sh
chmod +x install.sh
./install.sh

Chemins d'installation :

  • Installation système : /usr/local/bin (nécessite sudo, déjà dans le PATH)
  • Installation utilisateur : ~/.local/bin (sans sudo, ajout au PATH automatique)

📖 Commandes

🏗️ Gestion de repository

Commande Description Flags
he createrepo <nom> Créer un nouveau repository GitHub -pr (privé), -pu (public), -d (auto-delete branches), -pages (GitHub Pages)
he fastpush <url> Push rapide vers un repository existant -m <message> (message de commit)
he update Commit + Pull + Push complet -m <message> (message de commit)

Exemples :

# Créer un repo public avec GitHub Pages
he createrepo mon-site -pu -pages

# Créer un repo avec auto-suppression des branches
he createrepo mon-projet -pu -d

# Push rapide avec message
he fastpush https://github.com/user/repo.git -m "Initial commit"

# Synchronisation avec message
he update -m "feat:  nouvelle fonctionnalité"
#### 🤖 Génération automatique de messages de commit

HE CLI peut générer automatiquement des messages de commit intelligents en analysant vos modifications avec IA locale (Ollama).

**Prérequis** : Python 3.7+ et Ollama installés

| Commande | Modèle | Vitesse | Description |
|----------|--------|---------|-------------|
| `he update -a` | phi3:mini | 2-3s | **Recommandé** - Meilleure qualité |
| `he update -a -f` | gemma2:2b | 1-2s | Ultra-rapide pour commits fréquents |

**Options avancées du générateur :**

```bash
# Génération basique (qualité normale)
python generate_message.py

# Mode strict (score >= 9/10) avec feedback détaillé
python generate_message.py --strict --verbose

# Analyse seulement les fichiers staged
python generate_message.py --staged

# Génération en anglais
python generate_message.py --language en

# Combinaison : rapide + staged
python generate_message.py --fast --staged

Fonctionnalités :

  • Analyse intelligente : 4000 caractères de diff (10x plus qu'avant)
  • Sécurité : Masquage automatique des secrets (.env, API keys, tokens)
  • Validation : Score de qualité 0-10 avec feedback détaillé
  • Auto-correction : Corrige majuscules, points finaux, préfixes
  • Guidelines projet : Support de COMMIT_MESSAGE.md personnalisé
  • Multi-langues : Français (défaut), anglais, espagnol, etc.
  • Retry intelligent : Jusqu'à 3 tentatives avec ajustement du prompt

Exemple avec feedback (mode verbose) :

$ python generate_message.py --verbose

✅ Guidelines trouvées : COMMIT_MESSAGE.md
🔄 Collecte du contexte Git...
   • 3 fichiers modifiés
   • Diff : 2847 caractères
   • Secrets masqués : 2 patterns

🔄 Tentative 1/3...
📊 Score : 9/10
Message : feat(cli): ajoute la commande backup automatique

💡 Suggestions :
   ✅ Scope présent (bonne pratique)
   ✅ Format conventionnel

✅ Message validé !

feat(cli): ajoute la commande backup automatique

Créer des guidelines personnalisées :

Créez un fichier COMMIT_MESSAGE.md à la racine de votre projet :

# Règles de commit pour mon projet

## Format requis
- Type : feat, fix, docs, style, refactor, chore
- Scope obligatoire : cli, git, backup, config
- Maximum 60 caractères
- En français uniquement

## Exemples valides
- feat(cli): ajoute la commande backup
- fix(git): corrige l'encodage UTF-8
- docs(readme): met à jour les instructions

---

### 📜 Historique et gestion

| Commande | Description | Arguments |
|----------|-------------|-----------|
| `he rollback` | Annuler le dernier commit (soft reset) | `-d` (confirmation auto) |
| `he logcommit [nombre]` | Afficher l'historique des commits | Nombre de commits (défaut : 10) |
| `he backup` | Créer une archive ZIP du projet | Aucun |

**Exemples :**
```bash
# Annuler le dernier commit
he rollback

# Voir les 20 derniers commits
he logcommit 20

# Créer un backup
he backup

📝 Documentation

Commande Description Options
he readme Générer automatiquement un README. md avec IA -Path <chemin> (chemin du projet)

Prérequis pour he readme :

  • Python 3.7+ (installation proposée si absent)
  • Ollama installé localement (installation guidée)
  • Modèle qwen2.5-coder (téléchargement automatique)

Fonctionnalités :

  • ✅ Analyse automatique du code source (respecte .gitignore)
  • ✅ Détection des TODOs et FIXME
  • ✅ Génération de la structure (installation, architecture, stack technique)
  • ✅ Backup automatique du README existant (.bak)
  • ✅ Choix de la langue (Français/Anglais)
  • ✅ Instructions personnalisables
  • ✅ Optimisation automatique selon la RAM disponible
  • ✅ Fallback : création d'un README basique si échec

Exemples :

# Générer le README du projet actuel
he readme

# Générer le README d'un projet spécifique
he readme -Path "C:\MesProjets\MonApp"

🔧 Maintenance

Commande Description Options OS supportés
he maintenance Maintenance complète du système --preview (aperçu sans modification)
--exclude <packages> (exclure des packages Python)
Windows, Linux, macOS
he selfupdate Mettre à jour HE CLI Aucune Tous

Maintenance inclut :

  • Tous les OS : Mise à jour des packages Python globaux (pip, packages obsolètes)
  • Windows : Winget update, DISM, SFC, nettoyage disque, CHKDSK
  • Linux : APT/DNF/Pacman update, nettoyage packages, journaux systemd
  • macOS : Homebrew update & cleanup

Options avancées :

# Aperçu des mises à jour sans les effectuer
he maintenance --preview

# Exclure certains packages Python de la mise à jour
he maintenance --exclude numpy tensorflow torch

# Combinaison : aperçu avec exclusions
he maintenance --preview --exclude pandas scikit-learn

Packages Python mis à jour :

  • ✅ pip (toujours mis à jour en premier)
  • ✅ Tous les packages obsolètes détectés
  • ✅ Support des exclusions pour packages critiques
  • ✅ Affichage des versions (actuelle → nouvelle)

Exemples :

# Maintenance du système
he maintenance

# Mise à jour de HE CLI
he selfupdate

🎨 Utilitaires

Commande Description
he heian Afficher le logo Heian Enterprise
he matrix Effet Matrix dans le terminal
he help Afficher l'aide complète
he cs Lance une partie de cs dans le terminal
he flash Lance une grenade flash dans le terminal

💡 Exemples d'utilisation

Créer un nouveau projet GitHub avec documentation automatique

# Créer un dossier et initialiser
mkdir mon-projet
cd mon-projet

# Créer le repository public sur GitHub
he createrepo mon-projet -pu

# Ajouter du code... 
echo "console.log('Hello');" > index.js

# Générer automatiquement le README
he readme

# Synchroniser avec GitHub
he update -m "docs: add auto-generated README"

Créer un site web avec GitHub Pages

# Créer le projet
mkdir mon-site
cd mon-site

# Ajouter un fichier HTML
echo "<h1>Mon Site</h1>" > index.html

# Créer le repo avec GitHub Pages activé
he createrepo mon-site -pu -pages

# Votre site sera disponible à :  https://votre-username.github.io/mon-site

Workflow de développement complet

# Cloner un projet existant
git clone https://github.com/user/repo.git
cd repo

# Faire des modifications...
echo "New feature" >> feature.js

# Voir l'historique
he logcommit 5

# Créer un backup avant modification importante
he backup

# Faire d'autres modifications... 

# Annuler le dernier commit si erreur
he rollback

🔄 Mise à jour

# Mettre à jour HE CLI vers la dernière version
he selfupdate

La commande détecte automatiquement votre OS et télécharge la bonne version.


🗑️ Désinstallation

Windows

# Télécharger et exécuter
curl -O https://raw.githubusercontent.com/Lelio88/he_CLI/main/uninstall.bat
.\uninstall.bat

Linux/macOS

# Télécharger et exécuter
curl -fsSL https://raw.githubusercontent.com/Lelio88/he_CLI/main/uninstall.sh | bash

La désinstallation :

  • Supprime tous les fichiers installés
  • Nettoie le PATH automatiquement
  • Crée un backup de vos fichiers de configuration shell

🌍 Compatibilité

OS Version minimale Package Manager Notes
Windows 10/11 PowerShell 5.1+ Winget Installé par défaut
Ubuntu/Debian 20.04+ APT PowerShell Core installé automatiquement
Fedora 35+ DNF PowerShell Core installé automatiquement
RHEL/CentOS 8+ DNF PowerShell Core installé automatiquement
Arch Linux Rolling Pacman PowerShell Core via AUR
macOS 11+ (Big Sur) Homebrew Homebrew requis

Shells supportés

  • Windows : PowerShell, CMD
  • Linux/macOS : bash, zsh, fish

🤝 Contribution

Les contributions sont les bienvenues ! N'hésitez pas à :

  1. 🍴 Forker le projet
  2. 🔧 Créer une branche (git checkout -b feature/AmazingFeature)
  3. 💾 Commiter vos changements (git commit -m 'feat: add amazing feature')
  4. 📤 Pusher vers la branche (git push origin feature/AmazingFeature)
  5. 🔃 Ouvrir une Pull Request

📜 Licence

MIT License - Copyright (c) 2025 Lelio B

Voir le fichier LICENSE pour plus de détails.


👤 Auteur

Lelio B - @Lelio88

Version 1.2.0 - 2025-12-10


💬 Support


Made with ❤️ by Lelio B

⭐ Si ce projet vous aide, n'hésitez pas à lui donner une étoile !

About

Un outil CLI puissant pour gérer vos projets Git et GitHub avec simplicité. Créez des repos, synchronisez votre code, gérez vos commits et créez des backups en une seule commande !

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •