Interface en ligne de commande (CLI)

L'interface CLI de Willet expose les mêmes opérations que les outils MCP, utilisables en script depuis n'importe quel shell.

Installer

Le CLI est publié sur npm et nécessite Node.js 20 ou une version plus récente.

npm install -g @willet/cli

Le binaire installé est willet. Il se connecte à Willet Cloud par défaut : https://willet.bgenc.dev.

Se connecter (Willet Cloud)

Pour une utilisation interactive, connectez-vous via le navigateur. Cela ouvre une page d'autorisation d'appareil et stocke un token de courte durée sous ~/.willet/.

willet login

Une fois approuvé, confirmez l'identité active :

willet whoami

Effacer les identifiants stockés avec willet logout.

Utiliser un secret d'API (scripts, CI, auto-hébergé)

Pour une utilisation sans interface, ignorez la connexion par navigateur et fournissez un secret dans WILLET_API_TOKEN.

export WILLET_API_TOKEN=...
willet whoami

La portée est soit user (tous les projets auxquels vous avez accès) soit project (un seul projet).
Le niveau d'accès est read (lecture seule) ou read_write (accès complet).
`WILLET_API_TOKEN` est prioritaire sur une session stockée et n'est jamais écrit sur le disque.

Cibler un serveur auto-hébergé

Pointez le CLI vers votre propre serveur Willet de trois façons (par ordre de priorité décroissante) :

--api-url <url> un flag global sur n'importe quelle commande
WILLET_API_URL une variable d'environnement
apiUrl un champ apiUrl dans ~/.willet/config.json

Les serveurs auto-hébergés ne prennent pas en charge la connexion Willet ; authentifiez-vous avec `WILLET_API_TOKEN` défini sur un secret utilisateur extrait du fichier de configuration du serveur.

Sortie & scripts

--json affiche du JSON brut plutôt qu'un résumé lisible ; redirigez-le vers un outil comme jq.
-p <projectId> la plupart des commandes de tâche nécessitent un UUID de projet.
le flag tags est séparé par des espaces, pas par des virgules : --tags backend perf

willet --json ticket create "Set up CI" -p $PROJECT --type chore --tags ci infra

Référence des commandes

Les commandes sont regroupées par ressource. Chaque groupe possède ses propres sous-commandes :

Groupe	Sous-commandes
`willet ticket`	list, search, get, create, update, delete, start, complete, cancel, reopen, comment, link, unlink, graph, tags
`willet project`	list, create, delete, restore, set-key-prefix, stats, members
`willet org`	list, create, update, delete, members
`willet github`	list, link, unlink
`willet render`	board, dependency-graph

Consultez les options exactes de n'importe quelle commande avec willet <group> --help.

Codes de sortie

Les scripts peuvent se ramifier selon le code de sortie du processus :

`0`	Succès
`1`	Erreur générique ou réseau
`2`	Échec de l'authentification (401)
`3`	Interdit (403), p. ex. un secret en lecture seule utilisé pour une écriture
`4`	Introuvable (404)

Tout ce que fait le CLI, il le fait via l'API REST. Utilisez l'API directement si vous préférez ne pas passer par le shell.

Référence de l'API REST →