Referencia completa del CLI

Todos los comandos disponibles en @whet/cli. Cada link lleva a la página detallada.

Stack + clients

Comando	Descripción
whet install	Bootstrap de laptop fresco. Provisiona ~/.whet/, genera secrets, levanta el stack, sondea /health. Flags: --dest, --source-compose-path, --source-env-path, --skip-up, --skip-probe, --force-reset.
whet init	Cableado one-shot de MCP clients contra un deployment en marcha. Flags: --bearer-token, --backend-url, --mcp-url, --claude-code-scope, -y/--yes.
whet install-skill	Reinstala solo el markdown del skill de Claude Code. Flags: --dest, -f/--force.
whet status	Sondea backend + whet-app locales + lista credenciales OAuth. Flags: --backend-base-url, --web-app-url, --api-key.
whet doctor	Diagnóstico de docker, env, containers, backend, web-app, OAuth y headroom de rate-limit de X. Flags: --backend-base-url, --web-app-url, --api-key, --skip-x-headroom.

Autenticación

Comando	Descripción
whet auth login	Guarda el agent token + base URL en ~/.whet/config.json. Flags: -t/--token (required), -u/--base-url.
whet auth status	Muestra la config actual (token enmascarado). Solo lee local.
whet auth x	Linkear por OAuth una cuenta de X (flujo PKCE, callback local en :11789). Flags: --backend-base-url, --api-key, --no-open, --timeout.
whet auth grok	Linkear por OAuth una cuenta de Grok (xAI). Mismos flags que auth x.

Pipelines y artifacts

Comando	Descripción
whet pipelines new	Crea un pipeline desde intent. Flags: -s/--source (required: x/webpage), --handle, --url, --kind, --scope, --tone, --auto-fanout, --auto-publish.
whet inbox <pipeline_id>	Lista artifacts pendientes + ready. Flag: -l/--limit.
whet publish <artifact_id>	Marca un artifact como publicado. Flags: --final-text, --reason.

Adapters y credentials

Comando	Descripción
whet adapter install <source>	Instala un adapter desde URL de git (#<ref>), URL de tarball (--sha256) o path local. Flags: --sha256, -y/--yes, -f/--force, --allow-mutable-ref, --offline.
whet adapter list	Lista los adapters instalados.
whet adapter remove <name>	Remueve un adapter instalado. Las credentials del vault del backend quedan.
whet credentials add <adapter> <name>	Guarda una credencial encriptada. Pasá --field key=value (repetible) o --from-file <path>. Flags: --label, --field, --from-file, -y/--yes.
whet credentials list	Lista credentials de adapters para la organización actual. Flag: --adapter.
whet credentials remove <adapter> <name>	Hard-delete de una credencial. Flags: --label, -y/--yes.

Entradas detalladas

whet install-skill

Instala el markdown del skill de Whet en ~/.claude/skills/whet.md. Útil si querés el skill sin correr init completo.

Flag	Descripción
--dest <path>	Override del path de destino.
-f, --force	Sobrescribe un archivo existente con contenido distinto.

whet status

Sondea el deployment en marcha e imprime el estado del bearer token resuelto, la salud del backend y la lista de credenciales OAuth (X, Grok) conectadas a la organización activa.

Flag	Descripción
--backend-base-url <url>	Override de BACKEND_BASE_URL.
--web-app-url <url>	Override de la URL de la web-app. Default http://localhost:3000.
--api-key <key>	Bearer key del backend. Fallback a WHET_API_KEY.

whet doctor

Corre un diagnóstico completo. Chequea el daemon de Docker, la presencia de .env.local, la salud de los containers, el /health del backend, la responsividad de la web-app, las credenciales OAuth y el headroom del rate-limit del API de X (salvo que pases --skip-x-headroom).

Flag	Descripción
--backend-base-url <url>	Override de BACKEND_BASE_URL.
--web-app-url <url>	Override de la URL de la web-app.
--api-key <key>	Bearer key del backend.
--skip-x-headroom	Saltea el probe de rate-limit del API de X (usar cuando deliberadamente se removieron las credenciales de X).

Ayuda

whet --help            # lista top-level commands
whet <comando> --help  # detalle del comando + ejemplos
whet --version         # versión instalada

Forma de los IDs

Recurso	Prefijo (observado en MCP/Agent API)
Pipeline	pp_<uuid>
Run	run_<uuid>
Riff (artifact prose)	rf_<uuid>
Brief (artifact multi-source)	bf_<uuid>
Post scrapeado	tw_<id>
Webpage snapshot	ws_<uuid>
Agent token	string hex de 64 chars, sin prefijo (ej. 7a3f4b2c…e2d8)

Los IDs son opacos: no los parsees ni asumas longitud. Si necesitás filtrar por tipo, usá los endpoints que ya filtran. "Artifact" es un término sombrilla — los artifacts concretos son riffs (single source) o briefs (multi-source) y cada uno tiene su prefijo.

Lo que NO existe (común que se busque)

• No hay flag --no-confirm en publish — el comando no tiene confirmación interactiva, ejecuta directo.
• No hay flag --json en inbox ni en otros comandos. El output es texto renderizado con Ink.
• No hay env vars WHET_TOKEN / WHET_BASE_URL. El CLI solo lee ~/.whet/config.json.
• No hay comando whet pipelines pause / archive / update. Esas operaciones viven en la UI.
• No hay comando de refinement directo. Usá el prompt MCP refine_post o la UI.