Interfaz de línea de comandos (CLI)

La CLI de Willet expone las mismas operaciones que las herramientas MCP, ejecutables desde cualquier shell.

Instalar

La CLI está publicada en npm y requiere Node.js 20 o superior.

npm install -g @willet/cli

El binario instalado es willet. Por defecto se conecta a Willet Cloud: https://willet.bgenc.dev.

Iniciar sesión (Willet Cloud)

Para uso interactivo, inicia sesión desde el navegador. Esto abre una página de autorización de dispositivo y almacena un token de corta duración en ~/.willet/.

willet login

Una vez aprobado, confirma la identidad activa:

willet whoami

Borrar credenciales guardadas con willet logout.

Usa un secreto de API (scripts, CI, autoalojado)

Para uso desatendido, omite el inicio de sesión en el navegador y proporciona un secreto en WILLET_API_TOKEN.

export WILLET_API_TOKEN=...
willet whoami

El ámbito es user (todos los proyectos a los que tienes acceso) o project (un único proyecto).
El nivel de acceso es read (solo lectura) o read_write (acceso completo).
`WILLET_API_TOKEN` tiene prioridad sobre un inicio de sesión almacenado y nunca se escribe en disco.

Apunta a un servidor propio

Apunta el CLI a tu propio servidor de Willet de cualquiera de estas tres formas (de mayor a menor precedencia):

--api-url <url> un indicador global en cualquier comando
WILLET_API_URL una variable de entorno
apiUrl un campo apiUrl en ~/.willet/config.json

Los servidores propios no admiten el inicio de sesión de Willet; autentícate con WILLET_API_TOKEN configurado con un secreto de usuario del archivo de configuración del servidor.

Salida y scripts

--json imprime JSON sin procesar en lugar de un resumen legible; redirigidlo a una herramienta como jq.
-p <projectId> la mayoría de los comandos de tareas necesitan un UUID de proyecto.
el flag de etiquetas está separado por espacios, no por comas: --tags backend perf

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

Referencia de comandos

Los comandos están agrupados por recurso. Cada grupo tiene sus propios subcomandos:

Grupo	Subcomandos
`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

Consulta los flags exactos de cualquier comando con willet <group> --help.

Códigos de salida

Los scripts pueden bifurcarse según el código de salida del proceso:

`0`	Éxito
`1`	Error genérico o de red
`2`	Error de autenticación (401)
`3`	Prohibido (403), p. ej. un secreto de solo lectura usado para una escritura
`4`	No encontrado (404)

Todo lo que hace el CLI, lo hace a través de la API REST. Usa la API directamente cuando no quieras tirar de la línea de comandos.

Referencia de la API REST →