2026-08-11 · 10 min de lectura · plane-cli
plane-cli: un cliente de Plane que imprime el siguiente comando por ti
Bun, un binario, confirmaciones de escritura para agentes de IA, y por qué importan los UUID en la ayuda.
Uso Plane para tracking. La UI web está bien. La API está bien. Lo que no estaba bien era vivir en el navegador para “listar bugs urgentes, comentar, mover estado” mientras ya vivía en la terminal con agentes.
Así que escribí plane-cli — un binario plane autocontenido. Bun compile, sin runtime Node en el destino. Cloud o self-hosted. MIT. Solo.
La apuesta de UX
La mayoría de CLIs tiran JSON o una tabla bonita y te dejan solo.
Esta imprime bloques Next (copy-paste ready) con UUIDs reales rellenados. Así enseñas a humanos y agentes la gramática sin abrir docs.
Arquitectura (mantenerla aburrida)
| Capa | Trabajo |
|---|---|
index.ts | settings, dispatch, errores |
cli/ | parsear args, árbol de comandos, help generado |
commands/ | un módulo por recurso; comandos como datos |
api/ | cliente tipado como api.project(id).item(id) |
render/ | todo lo impreso — los comandos no formatean |
config.ts / state.ts / history.ts | .planerc, .plane/, log local |
El help se genera del árbol de comandos. Si el help puede desviarse de la realidad, se desviará. Hice el desvío difícil.
Confirmación de escritura (la feature de agentes)
La primera escritura contra un proyecto en un directorio se detiene, muestra exactamente qué haría, y sale. Re-ejecuta con --yes. Una vez por proyecto por directorio.
También dice a los asistentes de IA que reformulen el cambio en palabras planas y esperen. Plane no tiene undo.
Open source
github.com/mubashirjamali101/plane-cli
Si construyes CLIs para flujos con agentes: imprime el siguiente comando, confirma escrituras, genera help desde datos.