starhui-dev/huly-cli

Huly CLI

Utilisez npx -y @starhui/huly-cli@latest pour travailler avec Huly via @firfi/huly-mcp.

Pour le développement local dans ce dépôt, huly est également utilisable après pnpm build && pnpm link --global.

Vérifications rapides

1. Vérifiez que le CLI est disponible :

   npx -y @starhui/huly-cli@latest --version
   

2. Vérifiez d'abord la configuration sanitizée à partir des variables d'environnement existantes :

   npx -y @starhui/huly-cli@latest context
   

3. Si une configuration requise est manquante, demandez à l'utilisateur s'il faut passer un fichier dotenv explicite avec --config <chemin>.
4. Si le projet est omis pour les commandes de tickets, définissez HULY_DEFAULT_PROJECT ou passez --project.

N'affichez jamais de véritables jetons, mots de passe ou le contenu complet d'un fichier .env. npx -y @starhui/huly-cli@latest context est sûr car il renvoie une configuration sanitizée.

Commandes courantes

Lister les projets :

npx -y @starhui/huly-cli@latest project list --json

Découvrir les statuts avant de créer ou mettre à jour des tickets :

npx -y @starhui/huly-cli@latest project statuses HULY --json

Lister les tickets :

npx -y @starhui/huly-cli@latest issue list --project HULY --status-category active --limit 20 --json

Obtenir un ticket :

npx -y @starhui/huly-cli@latest issue get HULY-123 --project HULY --json

Créer un ticket :

npx -y @starhui/huly-cli@latest issue create --project HULY --title "Titre impératif court" --description "Corps en Markdown"

Mettre à jour un ticket :

npx -y @starhui/huly-cli@latest issue update HULY-123 --project HULY --status Done

Rechercher :

npx -y @starhui/huly-cli@latest search "texte de la requête" --limit 10 --json

Accès brut aux outils

Utilisez les appels bruts lorsque le CLI de premier niveau n'expose pas un outil MCP amont :

npx -y @starhui/huly-cli@latest tools --filter document
npx -y @starhui/huly-cli@latest call get_issue --field project=HULY --field identifier=HULY-123 --json
npx -y @starhui/huly-cli@latest call list_projects --data '{"limit":10}' --json

--field clé=valeur interprète true, false, null et les nombres. Utilisez --data ou --file pour du JSON imbriqué.

Sécurité

• Utilisez --json pour l'analyse par l'agent.
• Lisez avant d'écrire : inspectez le projet/statut/ticket avant de le modifier, sauf si l'utilisateur a donné des valeurs exactes.
• Les commandes destructrices nécessitent une confirmation ; ne passez --yes que lorsque l'utilisateur a explicitement demandé la suppression.
• Préférez les noms de statuts provenant de project statuses ; n'inventez pas de statuts de workflow.
• Si une commande échoue en raison de l'authentification ou de la configuration, signalez les champs sanitizés manquants de npx -y @starhui/huly-cli@latest context ; n'exposez pas de secrets. Ne réessayez qu'avec --config <chemin> après que l'utilisateur a confirmé le fichier dotenv à utiliser.

Correspondance utile

• Projets : project list, project get, project statuses, project create, project update, project delete.
• Tickets : issue list, issue get, issue create, issue update, issue delete, issue label, issue unlabel, issue move.
• Recherche globale : search.
• Tous les outils MCP amont : tools et call.