Agentes de código

Agentes de programación

Claude Code, Codex, Cursor y otros agentes de programación con IA despliegan y gestionan apps en Lizard (lizard.build) mediante Lizard CLI. Instala Lizard Skill una vez con npx skills add lizard-build/skill -g; después, el agente carga la guía integrada en la CLI con lizard skills get core --json y lee los flags de cualquier comando con --help --json. Así obtiene la sintaxis de la versión instalada. Los clientes compatibles con MCP, como ChatGPT y Claude, pueden usar Lizard MCP en su lugar. Para un despliegue completo desde un agente, consulta Desplegar desde Claude Code, Codex o Cursor.

La skill integrada

La CLI incluye la guía de uso de su propia versión. Un agente la lee con:

lizard skills get core --json

Esto devuelve { name, frontmatter, content, … }: content es la guía completa (pipeline de build, precedencia de env, addons, descubrimiento, códigos de salida). Subcomandos relacionados:

lizard skills list        # available embedded skills
lizard skills get core    # the core guide
lizard skills path        # where skills are stored

Como la guía viene incluida con el binario, lizard upgrade también actualiza las instrucciones del agente.

Comandos autodescriptivos

Los agentes descubren la sintaxis exacta de los flags en tiempo de ejecución en lugar de depender de una sintaxis memorizada:

lizard --help --json                # full command tree + exit codes
lizard <cmd> --help --json          # a specific command's schema

Consulta JSON y automatización.

Inicialización dentro de un agente

Un flujo típico de un agente:

  1. Cargar la guía: lizard skills get core --json → leer content.
  2. Comprobar la autenticación al ejecutar la tarea: ejecuta la tarea del usuario; con el código de salida 2, ejecuta lizard login, entrega al usuario la URL impresa y luego reintenta.
  3. Iniciar la prueba si se solicita: una cuenta nueva no tiene plan, así que su primera creación falla con HTTP 402 (code: "PAYMENT_REQUIRED", código de salida 1). Ejecuta lizard billing start --json, entrega al usuario la url de Checkout y reintenta cuando haya añadido una tarjeta.
  4. Resolver el contexto antes de modificar: lizard status (enlace cwd) y lizard ps --json (servicios).
  5. Actuar usando la guía: add, up, secrets, domain, etc., siempre con --json.

Si el binario lizard no está presente, instálalo primero. En macOS o Linux, usa el script de instalación:

curl -fsSL https://lizard.build/install.sh | bash

No necesita Node.js ni sudo, y enlaza lizard en una carpeta que ya está en el PATH, así que el agente puede llamarlo en la misma sesión. Si el script avisa de que quizá no se encuentre lizard, llama a ~/.lizard/bin/lizard. En Windows, ejecuta esto en PowerShell:

irm https://lizard.build/api/cli/install.ps1 | iex

O instala desde npm en cualquier sistema:

npm install -g @lizard-build/cli

Convenciones que los agentes deben seguir

  • Pasa siempre --json en llamadas no interactivas.
  • Confirma las acciones destructivas (eliminar servicio, quitar addon, sobrescribir un secreto de todo el proyecto, reinicio de prod) con el usuario: los propios prompts de la CLI solo se activan en un TTY.
  • Limita los secretos al servicio que los consume por defecto; reserva --global para valores que sepas que son públicos. Consulta Variables y secretos.
  • No escribas Dockerfiles sin que se soliciten: lizardpack detecta automáticamente la mayoría de los stacks. Prueba primero un despliegue. Consulta Pipeline de build.
  • No uses lizard up para cambiar un servicio respaldado por git a upload: usa service set + redeploy.

Integraciones con editores

Lizard Skill incluye las instrucciones iniciales que permiten a los agentes de editores y asistentes cargar la guía cuando la necesiten y usar la CLI que describe esta documentación. Instálala una sola vez para todos tus agentes:

npx skills add lizard-build/skill -g

Funciona con Claude Code, Cursor, Codex, Copilot, Gemini CLI y otros agentes que leen el formato Agent Skills. Para los clientes que usan MCP en lugar de ejecutar comandos de shell, usa Lizard MCP.

Eso también cubre los IDE con IA: escriben y prueban una app, pero no la alojan. Consulta desplegar una app creada en Google Antigravity, que muestra cómo pedir el despliegue con un solo prompt.

Para que Claude Code o ChatGPT editen la página que tienes abierta en Chrome, usa Lizard Studio.

Lizard MCP

Lizard MCP permite que ChatGPT, Claude y otros clientes MCP gestionen tus proyectos de Lizard: crear servicios y addons, redesplegar, leer logs y métricas, definir secretos, escalar réplicas y asociar dominios. Es un servidor alojado que usa Streamable HTTP en:

https://employ-woman-g1q2.us-east-1.onlizard.com/mcp

Un cliente que admita OAuth te hace iniciar sesión en el primer uso. Otros clientes envían una clave de API liz_ en la cabecera Authorization: Bearer; crea una con lizard keys create <name>.

Añádelo a Claude Code:

claude mcp add --transport http lizard https://employ-woman-g1q2.us-east-1.onlizard.com/mcp

Para Cursor y otros clientes configurados mediante JSON:

{
  "mcpServers": {
    "lizard": {
      "url": "https://employ-woman-g1q2.us-east-1.onlizard.com/mcp",
      "headers": { "Authorization": "Bearer liz_your_key" }
    }
  }
}

Puedes iniciar la prueba, pagar y cancelar Pro desde la página de Billing. Cuando la cuenta tiene que pagar antes de poder crear algo, el error de la herramienta incluye PAYMENT_REQUIRED y el enlace que hay que abrir.

Alojar tu propio servidor MCP

Un agente que usa Lizard CLI y una aplicación que expone MCP son flujos de trabajo separados. Los comandos de CLI anteriores no proporcionan un transporte MCP. Para desplegar tu propio servidor con Streamable HTTP, sigue la guía de MCP remoto.

Ver también

Panel de la app

Actualizado