Comandos de la CLI
Todo lo que la herramienta de línea de comandos puede hacer, agrupado por lo que intentas lograr.
Esto es todo lo que la herramienta puede hacer, agrupado por lo que intentas lograr: configurarla, correrla, revisarla y limpiar. Puedes correr cualquier comando seguido de --help para ver sus detalles.
Configurar
fragua login
Conecta esta computadora con tu cuenta de Fragua guardando tu token de agente. Si lo corres solo, te pide el token; o se lo pasas directo.
Opciones: --token para pasar el token, --base-url para una Fragua autoalojada, --name para etiquetar esta computadora, --concurrency para definir cuántos agentes corren a la vez.
fragua doctor
Revisa que todo esté listo —Claude, git, la CLI de GitHub y la conexión con Fragua— y señala lo que falte.
Opciones: --json para una salida legible por máquina.
fragua version
Muestra la versión instalada de la herramienta.
Correrla
fragua agent
Corre el worker en tu terminal. Se conecta, toma trabajo y corre agentes hasta que lo detienes; útil para una prueba rápida.
fragua agent install
Instala el worker como un servicio en segundo plano que arranca al iniciar sesión y se reinicia solo si se detiene. La forma habitual de correrlo a diario.
fragua agent start
Inicia ahora el servicio en segundo plano.
fragua agent stop
Detiene el servicio en segundo plano, dejándolo instalado.
fragua agent status
Muestra si el servicio en segundo plano está instalado y corriendo en este momento.
fragua agent uninstall
Quita el servicio en segundo plano. Tu configuración y tu token se quedan en su lugar.
Revisarla
fragua status
Muestra el nombre de esta computadora, los workspaces que está atendiendo y su configuración; todo leído localmente, sin necesidad de conexión.
Opciones: --check para también probar la conexión con Fragua, --json para una salida legible por máquina.
fragua logs
Muestra la actividad reciente del servicio en segundo plano.
Opciones: -n para definir cuántas líneas, --errors para mostrar solo los problemas, --file para leer un archivo de log específico.
Limpiar
fragua prune
Quita copias locales de workspaces que Fragua ya no administra. Se niega a tocar cualquier cosa con trabajo sin guardar o sin empujar.
Opciones: --yes para saltarte la confirmación.
fragua logout
Quita el token guardado de esta computadora. Tu configuración se queda; tendrás que iniciar sesión de nuevo para reconectar.
¿No sabes qué recibe un comando? Córrelo con --help; por ejemplo, fragua agent --help.
El inicio rápido te lleva paso a paso por instalarla y conectarla.