Guía de instalación de Ponytail: cómo usarlo con Codex, Claude Code y Gemini CLI

Wed, 24 Jun 2026 21:02:49 +0800

Ponytail es un plugin interesante para agentes de programación con IA.

No intenta hacer que la IA sea más llamativa. Hace lo contrario: le recuerda al agente que se detenga antes de escribir código y revise si la tarea puede resolverse sin código nuevo, reutilizando algo existente, usando una biblioteca estándar o aprovechando una capacidad nativa del navegador o de la plataforma.

Proyecto: DietrichGebert/ponytail

Si te pasa esto a menudo:

1
2
3

Solo querías un selector de fecha, pero la IA instaló una librería de componentes, escribió un wrapper, añadió estilos y empezó a hablar de zonas horarias.
Solo querías cambiar una pequeña lógica, pero la IA extrajo tres capas de helpers.
Solo querías corregir un bug, pero la IA refactorizó medio archivo.

La idea de Ponytail encaja muy bien: hacer que la IA se comporte como un desarrollador senior perezoso pero fiable, buscando primero el cambio mínimo.

Qué es Ponytail

Ponytail puede entenderse como un conjunto de reglas de trabajo para agentes de programación con IA.

Antes de escribir código, le pide al agente seguir una escalera:

1. ¿Esto realmente necesita existir?
2. ¿Ya existe en el código del proyecto?
3. ¿Puede hacerlo la biblioteca estándar?
4. ¿Puede hacerlo la plataforma de forma nativa?
5. ¿Puede hacerlo una dependencia ya instalada?
6. ¿Puede resolverse con una línea?
7. Solo al final, escribir el código nuevo justo necesario.

No es code golf ni búsqueda ciega de brevedad. Es una forma de evitar trabajo innecesario: borrar cuando se puede, reutilizar cuando se puede y usar capacidades nativas antes de reinventar la rueda.

El README incluye un ejemplo típico: un selector de fecha.

Una IA normal podría instalar flatpickr, escribir un wrapper, añadir estilos y explicar un montón de casos límite.

El estilo Ponytail primero piensa en:

`1`	`<input type="date">`

Ese es el tipo de juicio que intenta entrenar.

No resuelve “código corto”, sino “menos sobrediseño”

Ponytail se malinterpreta fácilmente como “hacer que la IA escriba una sola línea”.

Una descripción más precisa sería: hacer que la IA evite diseño innecesario.

Mantiene los límites de seguridad. No anima a eliminar validación, manejo de errores, seguridad o accesibilidad necesarios. Lo necesario se sigue haciendo; simplemente evita traer complejidad extra para una petición pequeña.

Encaja bien con:

Pequeñas funciones frontend;
Controles de formulario;
Funciones auxiliares simples;
Cambios de configuración;
Corrección de bugs pequeños;
Revisión de código para detectar sobreimplementación;
Restricciones antes de que la IA edite código;
Pedir al agente que busque implementaciones existentes primero.

No debe entenderse como:

Escribir siempre una sola línea;
No añadir nunca dependencias;
No refactorizar nunca;
Sacrificar mantenibilidad por reducir código;
Saltarse la lectura del código por velocidad.

Ponytail es perezoso para implementar, no para leer.

Herramientas compatibles

Según el README, Ponytail cubre muchas herramientas:

Claude Code;
Codex;
GitHub Copilot CLI;
Pi agent harness;
OpenCode;
Gemini CLI;
Antigravity CLI;
CodeWhale;
Swival;
OpenClaw;
Cursor, Windsurf, Cline, Aider, Kiro, Zed y otras herramientas basadas en archivos de reglas.

La ventaja es que no necesariamente tienes que cambiar tu herramienta principal.

Si usas Codex, instálalo como plugin de Codex. Si usas Claude Code, usa su marketplace de plugins. Si solo quieres las reglas en tu editor, puedes copiar los archivos correspondientes.

Cómo instalar Ponytail en Codex

Para Codex CLI, el README da este punto de entrada:

1
2

codex plugin marketplace add DietrichGebert/ponytail
codex

Luego, dentro de Codex:

Abre /plugins;
Selecciona el marketplace de Ponytail;
Instala Ponytail;
Abre /hooks;
Revisa y confía en sus dos lifecycle hooks;
Inicia una conversación nueva.

Para la app de escritorio de Codex, el README indica que reinicies la aplicación después de instalarlo para que el plugin sea detectado.

Un detalle importante: los plugins de Ponytail para Claude Code y Codex ejecutan dos pequeños lifecycle hooks en Node.js, así que node debe estar en PATH. El README también dice que, si falta node, las skills aún pueden funcionar, pero la activación always-on no será automática.

Comprueba primero:

node -v

Si no se encuentra el comando, instala Node.js o asegúrate de que el PATH del shell no interactivo pueda encontrar node.

Cómo instalarlo en Claude Code

En Claude Code:

`1`	`/plugin marketplace add DietrichGebert/ponytail`

Luego envía:

`1`	`/plugin install ponytail@ponytail`

El README recuerda que deben enviarse como dos mensajes separados.

Si usas la app de escritorio de Claude y no tienes /plugin, añade un marketplace personal desde la interfaz:

Abre Customize;
Haz clic en el signo más junto a personal plugins;
Crea un plugin y añade el marketplace;
Elige Add from repository;
Introduce la URL del repositorio GitHub de Ponytail.

Cómo instalarlo en GitHub Copilot CLI

Copilot CLI puede usar:

1
2

copilot plugin marketplace add DietrichGebert/ponytail
copilot plugin install ponytail@ponytail

En una sesión interactiva de Copilot CLI también puedes usar comandos slash:

1
2

/plugin marketplace add DietrichGebert/ponytail
/plugin install ponytail@ponytail

Después de instalarlo, Copilot CLI puede usar comandos Ponytail mencionados en el README, por ejemplo:

1
2

/ponytail:ponytail ultra
/ponytail:ponytail-review

Gemini CLI y Antigravity CLI

Para Gemini CLI:

`1`	`gemini extensions install https://github.com/DietrichGebert/ponytail`

Esto carga el conjunto de reglas como contexto de cada sesión y registra comandos /ponytail.

Para Antigravity CLI:

`1`	`agy plugin install https://github.com/DietrichGebert/ponytail`

El README también menciona que Google está renombrando Gemini CLI como Antigravity CLI, así que ambas rutas pueden coexistir durante un tiempo. Usa el nombre de CLI que tengas instalado.

Cómo usarlo con OpenCode

En OpenCode puedes añadir esto a opencode.json:

`1`	`{ "plugin": ["@dietrichgebert/ponytail"] }`

Si lo ejecutas desde un checkout local, puedes apuntar al archivo local del plugin:

`1`	`{ "plugin": ["./.opencode/plugins/ponytail.mjs"] }`

Es una buena opción si ya gestionas la configuración del proyecto con OpenCode.

Si solo quieres usar las reglas

El repositorio de Ponytail también incluye archivos de reglas para distintas herramientas:

AGENTS.md;
.cursor/rules/;
.windsurf/rules/;
.clinerules;
.github/copilot-instructions.md;
.kiro/steering/.

Si tu herramienta puede leer reglas a nivel de proyecto, puedes copiar el archivo correspondiente.

Por ejemplo, la extensión Codex para VS Code lee AGENTS.md. Si pones el AGENTS.md de Ponytail en la raíz del proyecto, o en una ubicación global de configuración de Codex, Codex podrá seguir ese estilo mediante reglas.

El plugin es más completo. El archivo de reglas es más ligero.

Prompts útiles con Ponytail

Después de instalarlo, no conviene esperar que todo mejore solo. También puedes escribir prompts que acompañen la dirección de Ponytail.

Por ejemplo:

`1`	`Please check whether similar code already exists first. Reuse existing code where possible, and only add the smallest new implementation if it does not exist.`

`1`	`Do not overengineer this request. First check whether the standard library, native HTML controls, or installed dependencies can solve it.`

Para code review:

`1`	`Review this change in the Ponytail style. Focus on over-abstraction, duplicate implementation, unnecessary dependencies, and places where native features can replace custom code.`

Estos prompts van en la misma dirección que Ponytail y suelen dar resultados más estables.

Tareas típicas para Ponytail

1. Controles frontend

Fechas, colores, subida de archivos, entradas numéricas, switches y selects.

La IA suele instalar una librería de componentes, pero muchas veces HTML nativo basta.

2. Funciones auxiliares

Eliminar duplicados, ordenar, formatear, manejar rutas o fechas.

Primero mira la biblioteca estándar y los helpers existentes antes de escribir una función nueva.

3. Cambios de configuración

ESLint, TypeScript, Hugo, Vite, Docker y CI.

Muchos problemas de configuración se resuelven con una línea, no con un script nuevo ni una toolchain nueva.

4. Bugs pequeños

Ponytail ayuda a encontrar el punto mínimo de corrección y evita que un bug termine en una gran refactorización.

5. Code review

Funciona bien como detector de sobrediseño.

Puedes pedirle a la IA que revise un diff y responda:

Si hay reinvención de algo existente;
Si hay dependencias nuevas innecesarias;
Si hay código que se puede borrar;
Si la implementación es más compleja que el requisito;
Si se pueden reutilizar módulos existentes.

Qué tener en cuenta

Ponytail tiene una buena dirección, pero no debería convertirse en un nuevo dogma.

No reduzcas código a costa de:

Validación de entrada;
Comprobación de permisos;
Protección contra pérdida de datos;
Seguridad de concurrencia y transacciones;
Privacidad del usuario;
Accesibilidad;
Manejo de errores;
Logs importantes;
Cobertura de pruebas.

Simple no significa descuidado.

Si una función toca seguridad, dinero, datos de usuarios u operaciones de producción, incluso la implementación mínima debe dejar claros los límites.

Mi forma recomendada de probarlo

Para una primera prueba:

Instálalo en un proyecto pequeño;
Prueba una solicitud que la IA suele sobrediseñar, como un selector de fecha o color;
Compara qué escribiría la IA sin Ponytail;
Pídele que revise un diff existente;
Luego llévalo a proyectos diarios.

No empieces con una gran refactorización.

Ponytail muestra más valor en tareas que son pequeñas en realidad, pero que la IA suele inflar.

Resumen en una frase

Ponytail no convierte la IA en una herramienta que solo escribe código corto. Hace que la IA se pregunte una cosa más antes de actuar:

`1`	`Does this code really need to be written?`

Si usas Codex, Claude Code, Copilot CLI, Gemini CLI u otros agentes de programación con IA y te molestan sus sobreimplementaciones, Ponytail merece una prueba. No decidirá toda la arquitectura por ti, pero añade una restricción útil: reutilizar primero, evitar desvíos y no reinventar la rueda.

Ponytail on KnightLi Blog