lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

herramienta intermedio agentesterminalmcpzig

fx: un agente de programación que se integra con la terminal

Usa un agente desde la terminal o llámalo desde scripts con salida JSON. Conecta tu proveedor y conserva sesiones sin instalar un runtime para la CLI.

✓ verificado el 27 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: revisa la instalación

Lee Install y Permissions en https://github.com/vercel-labs/fx. La CLI admite macOS y Linux. El comando oficial descarga y ejecuta el instalador; revísalo antes de usarlo:

curl -fsSL https://fx.sh/setup.sh | bash

Paso 2: conecta un proveedor

Elige un solo método documentado. Para Vercel AI Gateway:

fx login

Otros métodos están en Quick start del README. Comprueba sus costes y el modo de permisos.

Paso 3: prueba una consulta

Desde un repositorio de práctica con cambios conocidos, ejecuta la petición del ejemplo oficial traducida al español:

fx ask "Explica los cambios de este repositorio"

Para comprobar la respuesta JSON que usaría un script, el README documenta fx ask --json; aquí se adapta la petición y se guarda su salida:

fx ask --json "Explica los cambios de este repositorio" > respuesta-fx.json

Confirma que respuesta-fx.json es JSON válido y contiene la respuesta en final_output; no debe confundirse con la configuración de fx status --json. Para una sesión interactiva, el comando es fx.

Comprobación

fx doctor
fx status --json

Revisa el diagnóstico, el proveedor y los permisos. Contrasta ambas explicaciones con los cambios reales de código antes de encargar ediciones.

Si algo falla

Si no se encuentra el binario, revisa que ~/.local/bin esté en PATH. Si no responde el proveedor, comprueba su conexión con fx doctor. Para opciones de la versión instalada utiliza fx <command> --help, como indica la documentación.

ver en .md ¿Prefieres el recurso entero?

Qué es

fx es un agente de programación experimental de Vercel Labs escrito en Zig. Su CLI se distribuye como binario nativo y conserva la conversación en el historial de la terminal.

Para qué te sirve

  • Cuando quieres pedir una explicación desde un script.
  • Cuando necesitas que una herramienta lea la respuesta como JSON.
  • Cuando prefieres continuar sesiones desde la terminal y mantener tus atajos habituales.

Cómo funciona

El núcleo gestiona modelos, sesiones, permisos y herramientas de archivos, shell y web. La CLI ofrece conversación interactiva y solicitudes con fx ask. Los editores pueden conectarse mediante ACP; libfx expone el núcleo a aplicaciones JavaScript. Skills, servidores MCP y archivos AGENTS.md amplían su contexto y capacidades.

Antes de empezar

La CLI funciona en macOS y Linux, en x86_64 y arm64. El instalador usa ~/.local/bin. Debes conectar el método de acceso al modelo que elijas; el README documenta AI Gateway y suscripciones compatibles. La licencia Apache-2.0 del código no incluye consumo de modelos. Compilar el proyecto sí necesita la versión de Zig indicada en el README.

Límites y alternativas

El autor marca el estado como experimental. El modo auto ejecuta tareas rutinarias y somete otras acciones a una comprobación; no lo confundas con aislamiento del sistema operativo. Revisa el modo de permisos antes de dar acceso a código privado. Frente a otros agentes de terminal, su interés está en el binario nativo y las superficies de integración.

Recursos