Interfaz de línea de comandos (CLI)

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

Instalar

El CLI está publicado 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 guarda 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.

Usar 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 alcance puede ser user (todos los proyectos a los que tienes acceso) o project (un solo 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 self-hosted

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

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

Los servidores self-hosted no soportan el login 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; pásalo 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

Ve las opciones exactas 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`	Fallo 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 prefieras no depender del CLI.

Referencia de la API REST →