glosario
¿qué es una cli y por qué les encanta a los agentes?
TL;DR
Una CLI es un programa que controlas escribiendo comandos, como git, npm o docker. Los agentes de programación con IA ya se pasan el día escribiendo comandos, así que una CLI es lo más fácil de usar para ellos, sin ninguna integración especial. Las buenas CLI para agentes dan una salida corta y predecible y se explican a sí mismas cuando se les pide. Por eso la interfaz de control de Pane para agentes es runpane, una CLI que cualquier agente puede ejecutar.
CLI significa interfaz de línea de comandos. Es un programa que controlas escribiendo comandos en vez de hacer clic en botones. Seguro que ya usas varias: git, npm, docker.
gui frente a cli
Una GUI está hecha para los ojos y el ratón. Una CLI está hecha para escribir, que es lo que hacen los agentes.
| GUI (gráfica) | CLI (línea de comandos) | |
|---|---|---|
| cómo se usa | Haces clic y arrastras elementos | Escribes comandos |
| ejemplo | GitHub Desktop | git push |
| para personas | Suele ser más fácil al principio | Más rápida cuando conoces los comandos |
| para agentes | Difícil de usar: necesitan capturas y clics | Natural: los agentes ya escriben comandos |
por qué a los agentes les encantan las cli
Todos los agentes ya tienen una terminal, así que una CLI funciona con todos desde el primer día.
Los agentes de programación con IA pasan el día escribiendo comandos en terminales. Así ejecutan tu código, instalan paquetes, usan git y lanzan pruebas. Una CLI encaja con lo que ya hacen. No necesita una integración especial.
Por eso Pane creó runpane como CLI en vez de obligar a los agentes a usar un protocolo propio. Claude Code, Codex, Aider o un script de bash, da igual. Si puede escribir runpane panes create, puede controlar Pane.
qué hace que una cli esté pensada para agentes
Salida estructurada, una forma de descubrir comandos, salida corta y sin preguntas interactivas.
No todas las CLI funcionan igual de bien para los agentes. Esto es lo que importa:
- → Salida JSON. Los agentes no pueden procesar tablas para personas de forma fiable. Una opción
--jsonles da datos estructurados con los que sí pueden trabajar. - → Un comando de descubrimiento. Los agentes no deberían tener que leer la documentación para saber qué comandos existen. Un comando como
runpane agent-contextse lo cuenta todo con una sola llamada. - → Salida predeterminada corta. Los agentes tienen ventanas de contexto limitadas. Si un comando muestra 500 líneas por defecto, desperdicia tokens. Una buena CLI muestra poco y permite pedir más con opciones como
--limit 200. - → Modo no interactivo. Los agentes no pueden responder a mensajes como «¿Seguro? (s/n)». Una opción
--yesles permite saltarse las confirmaciones en flujos automatizados. - → Se puede consultar antes de instalar. Los agentes deberían poder comprobar qué hace una CLI antes de instalarla. Pane publica la lista completa de comandos en una URL pública para que puedan revisarla antes de decidir.
cómo aplica runpane estos principios
runpane cumple las cinco reglas, así que cualquier agente puede manejar Pane.
# Discovery: what commands exist?
runpane agent-context --json
# Short output: just what's on screen right now
runpane panels screen --panel <id> --limit 80 --json
# Non-interactive: skip the "are you sure?" prompt
runpane panes create --repo active --name "my-task" --yes --json
# Readable before install:
curl -fsSL https://runpane.com/runpane-cli-contract.jsonrelacionado
- → Documentación de la CLI runpane: la referencia completa
- → Página de la CLI runpane: por qué Pane creó una CLI
- → ¿Qué es MCP?: el protocolo que complementan las CLI
- → ¿Qué significa ser independiente del agente?: por qué lo permiten las CLI
Fuentes
- Correcciones
- Si algo de lo que hay aquí es incorrecto o está desactualizado, avísanos y lo corregiremos y actualizaremos la fecha de arriba. Abre una incidencia en GitHub
- Fuentes
preguntas frecuentes
Por Parsa Khazaeepoul, cofundador de Pane. .