CLI-Anything: dar a un agente acceso a software real
Arquitectura de CLI-Anything: comando, backend y preview
Separar el camino principal del canal de retroalimentación visual.
Qué aprenderás
- Camino del comando
- Camino del preview
- Dónde se decide la validez
Antes de empezar
- Paquetes de Python
- Una aplicación gráfica con backend real y licencia clara
Completar una prueba estrecha antes de publicar un comando comunitario.
Conclusiones clave
- Comandos y previews tienen roles distintos.
- El historial de sesión debe conservarse para reproducir.
- El artefacto nativo aporta la evidencia principal.
Camino del comando
Un harness analiza argumentos, valida estado, crea o modifica un proyecto y llama al backend real para exportar. La guía favorece JSON para agentes y errores claros si faltan dependencias.
Un REPL conserva contexto entre comandos; una CLI de una sola llamada facilita resultados deterministas. Elige según la aplicación, no por preferencia del prompt.
Camino del preview
El helper inspeccionado calcula una clave de caché, prepara rutas, escribe manifiestos y añade una trayectoria en vivo. Diferencia el estado mutable de sesión del historial acumulado.
Capturar preview es producir datos; CLI-Hub puede mostrarlos. La captura no debería alterar silenciosamente el proyecto original.
Dónde se decide la validez
El archivo nativo debe abrirse de nuevo en la interfaz gráfica y la exportación necesita inspección. Una miniatura bonita y un código de salida cero son evidencias más débiles.
El esquema interpreta especificación y helper; no representa la traza de un harness que hayamos ejecutado.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Seguir un comando hasta el proyecto nativo.
- 2
Identificar el proceso backend que renderiza.
- 3
Comparar manifiesto preview con exportación final.
Ejemplo para copiar
Command -> project file -> backend export; preview -> separate manifestPreguntas frecuentes
¿El bundle preview es el documento?
No. Reúne metadatos y vistas alrededor del proyecto.
¿Todos los harness necesitan REPL?
No. La guía admite diseños de una llamada o con estado.
Fuentes
- CLI-Anything / cli-anything-plugin/HARNESS.mdFuente verificada 2026-09-26
- CLI-Anything / cli-anything-plugin/preview_bundle.pyFuente verificada 2026-09-26