CLI fxc

Instalar

La CLI se compila desde el repositorio y se enlaza para tener el comando fxc:

git clone https://github.com/fazt/fxcode.git
cd fxcode && pnpm install
pnpm build:cli
cd apps/cli && npm link

Iniciar sesión

# Abre el navegador para aprobar el acceso (sirve con cuentas de GitHub)
fxc auth login --web --api-url https://api.fxcode.dev

# O con email y contraseña
fxc auth login --api-url http://localhost:4000 -e tu@correo.dev

fxc auth me

La sesión se guarda en ~/.fxcode/config.json y se renueva sola. Las variables FXC_API_URL y FXC_TOKEN tienen prioridad sobre ese archivo, útil en CI.

Lo esencial

fxc projects list
fxc tasks list --project-id <id> --status working --json
fxc tasks create -t "Revisar webhooks de Stripe" -s Working --project-id <id> --tag pagos
fxc tasks update <tareaId> -s Terminada

fxc ideas add -t "Exportar informes a PDF"
fxc ideas promote <ideaId> --project-id <id>

fxc projects notes add --project-id <id> --file informe.md
fxc changelogs create -v 1.4.0 --project-id <id> --content-file CHANGELOG.md

Grupo	Para qué
projects	Proyectos, enlaces, notas y equipo
tasks	Tareas, con estados y prioridades por nombre
ideas	Ideas sueltas o de proyecto, y su paso a tarea o proyecto
arch	La arquitectura: importar, ver, enlazar y foco
changelogs, proposals, quotes, payments, meetings	El resto del trabajo con clientes
mcp	El servidor MCP

Cada comando tiene --help. Los estados se pasan por nombre (-s "No Iniciada"), ignorando mayúsculas y tildes; un prefijo inequívoco también vale (-s work).

Buenas prácticas para scripts y agentes

• Pasa todas las opciones en create y update: sin ellas, la CLI pregunta y un proceso sin terminal se queda esperando.
• Usa --json siempre que vayas a leer la salida.
• Para textos largos (changelogs, notas), usa --content-file o --file en vez de pasar el texto como argumento; - lee de la entrada estándar.