Interfaccia a riga di comando (CLI)

La CLI di Willet espone le stesse operazioni degli strumenti MCP, utilizzabili tramite script da qualsiasi shell.

Installa

La CLI è pubblicata su npm e richiede Node.js 20 o versione successiva.

npm install -g @willet/cli

Il binario installato è willet. Di default si connette a Willet Cloud: https://willet.bgenc.dev.

Accedi (Willet Cloud)

Per l'uso interattivo, accedi tramite il browser. Si apre una pagina di autorizzazione del dispositivo e viene salvato un token di breve durata in ~/.willet/.

willet login

Una volta approvata, conferma l'identità attiva:

willet whoami

Cancella le credenziali salvate con willet logout.

Usa un segreto API (script, CI, self-hosted)

Per l'uso automatico, salta il login dal browser e fornisci un segreto in WILLET_API_TOKEN.

export WILLET_API_TOKEN=...
willet whoami

Lo scope è either user (tutti i progetti a cui hai accesso) o project (un singolo progetto).
Il livello di accesso è read (sola lettura) o read_write (accesso completo).
`WILLET_API_TOKEN` ha la precedenza su un login salvato e non viene mai scritto su disco.

Punta a un server self-hosted

Punta il CLI al tuo server Willet in uno di questi tre modi (precedenza dal più alto al più basso):

--api-url <url> un flag globale su qualsiasi comando
WILLET_API_URL una variabile d'ambiente
apiUrl un campo apiUrl in ~/.willet/config.json

I server self-hosted non supportano il login di Willet; autenticati impostando WILLET_API_TOKEN su un secret utente dal file di configurazione del server.

Output e scripting

--json stampa JSON grezzo invece di un riepilogo leggibile; reindirizzalo a uno strumento come jq.
-p <projectId> la maggior parte dei comandi per le attività richiede un UUID di progetto.
il flag tags è separato da spazi, non da virgole: --tags backend perf

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

Riferimento comandi

I comandi sono raggruppati per risorsa. Ogni gruppo ha i propri sottocomandi:

Gruppo	Sottocomandi
`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

Visualizza i flag esatti per qualsiasi comando con willet <group> --help.

Codici di uscita

Gli script possono diramarsi in base al codice di uscita del processo:

`0`	Successo
`1`	Errore generico o di rete
`2`	Autenticazione fallita (401)
`3`	Vietato (403), es. un segreto di sola lettura usato in scrittura
`4`	Non trovato (404)

Avanti

Tutto ciò che fa la CLI, lo fa tramite le REST API. Usa le API direttamente quando preferisci non usare la shell.

Riferimento alle REST API →