Que fait cli-anything-pm2 ?
Interface en ligne de commande sans état pour la gestion de processus PM2. Communique via le sous-processus PM2 CLI. Aucun état local ni session conservé.
Installation
pip install -e .
Prérequis :
- Python 3.10+
- PM2 installé globalement (
npm install -g pm2)
Utilisation
Commandes de base
# Afficher l'aide
cli-anything-pm2 --help
# Démarrer le mode REPL interactif
cli-anything-pm2
# Exécuter avec sortie JSON (pour consommation par agent)
cli-anything-pm2 --json process list
cli-anything-pm2 --json system version
Mode REPL
Lorsqu'invoqué sans sous-commande, la CLI entre dans une session REPL interactive :
cli-anything-pm2
# Saisissez les commandes de manière interactive avec complétion par tabulation et historique
Groupes de commandes
process
Commandes d'inspection des processus.
| Commande | Description |
|---|---|
list | Lister tous les processus PM2 |
describe <nom> | Obtenir des informations détaillées sur un processus |
metrics | Obtenir les métriques de tous les processus |
lifecycle
Commandes de cycle de vie des processus.
| Commande | Description |
|---|---|
start <script> --name <nom> | Démarrer un nouveau processus |
stop <nom> | Arrêter un processus |
restart <nom> | Redémarrer un processus |
delete <nom> | Supprimer un processus |
logs
Commandes de gestion des journaux.
| Commande | Description |
|---|---|
view <nom> --lines 50 | Afficher les journaux récents |
flush [nom] | Vider les journaux |
system
Commandes au niveau système.
| Commande | Description |
|---|---|
save | Sauvegarder la liste actuelle des processus |
startup | Générer un script de démarrage |
version | Obtenir la version de PM2 |
Formats de sortie
Toutes les commandes supportent deux modes de sortie :
- Lisible par l'humain (par défaut) : tableaux, couleurs, texte formaté
- Lisible par machine (flag
--json) : JSON structuré pour la consommation par agent
# Sortie humaine
cli-anything-pm2 process list
# Sortie JSON pour agents
cli-anything-pm2 --json process list
Pour les agents IA
Lors de l'utilisation programmatique de cette CLI :
- Utilisez toujours le flag
--jsonpour une sortie analysable - Vérifiez les codes de retour – 0 pour succès, non nul pour erreurs
- Analysez stderr pour les messages d'erreur en cas d'échec
Version
1.0.0