whet init

whet init cablea tus MCP clients (Claude Code, Claude Desktop, Cursor) contra un deployment Whet en marcha. Es el primer comando que se corre después de levantar el stack (ver whet install para el stack en sí).

¿Qué hace?

1. Sondea el endpoint /health del backend para confirmar que el stack responde.
2. Resuelve el bearer token del agente — desde --bearer-token, desde ~/.whet/config.json o desde un .env.local local (en ese orden).
3. Para cada MCP client detectado, escribe la entry JSON que apunta a tu MCP URL con el bearer token resuelto.
4. Verifica que el Agent API responde con el token resuelto.

Uso

whet init

Pasá --yes para saltar los prompts de consentimiento por cliente (modo agent-friendly):

whet init --yes

Flags

Flag	Tipo	Descripción
--bearer-token <value>	string	Usar este token en lugar de resolverlo desde .env.local o ~/.whet/config.json.
--backend-url <url>	string	Override de la URL de healthcheck del backend. Default http://localhost:3100/health.
--mcp-url <url>	string	Override de la URL del endpoint MCP que referencian los configs de los MCP clients. Default http://localhost:3000/api/mcp.
--claude-code-scope <scope>	user | project	Dónde instalar la entry de Claude Code. Default: autodetect best-effort.
-y, --yes	flag	Saltea los prompts de consentimiento por cliente. Requerido para runs unattended.

Si querés un reset destructivo (teardown + regen de secrets), usá whet install --force-reset, no whet init. init solo escribe configs de clientes; nunca toca los volumes de Docker.

Output esperado

$ whet init
✓ Backend reachable · http://localhost:3100/health 200
✓ Resolved bearer token from ~/.whet/config.json
✓ Wrote Claude Code MCP entry (user scope)
✓ Wrote Claude Desktop entry · ~/Library/Application Support/Claude/claude_desktop_config.json
✓ Wrote Cursor entry · ~/.cursor/mcp.json
✓ Agent API verification · 200 OK

Done. Restart your MCP clients to pick up the new entries.

¿Cuándo correrlo de nuevo?

• Después de correr whet install la primera vez.
• Después de rotar AGENT_API_TOKEN en .env.local y reiniciar el container whet-app.
• Después de mover el deployment a una URL distinta — pasá --mcp-url para actualizar todos los clients a la vez.

Relacionados

• whet install — provisioning del stack en un laptop fresco.
• whet install-skill — instala solo el markdown del skill de Claude Code.
• whet status — sondea el deployment en marcha.
• whet doctor — diagnóstico completo de docker/env/containers/backend/web/OAuth.