¿Qué hace cli-anything-anygen?
Una interfaz de línea de comandos con estado para AnyGen OpenAPI: genera diapositivas profesionales, documentos, sitios web, diagramas y más a partir de indicaciones en lenguaje natural. Diseñada para agentes de IA y usuarios avanzados.
Instalación
Esta CLI se instala como parte del paquete cli-anything-anygen:
pip install cli-anything-anygen
Requisitos previos:
- Python 3.10+
- anygen debe estar instalado en tu sistema
Uso
Comandos básicos
# Mostrar ayuda
cli-anything-anygen --help
# Iniciar modo REPL interactivo
cli-anything-anygen
# Crear un nuevo proyecto
cli-anything-anygen project new -o project.json
# Ejecutar con salida JSON (para consumo por parte del agente)
cli-anything-anygen --json project info -p project.json
Modo REPL
Cuando se invoca sin un subcomando, la CLI entra en una sesión REPL interactiva:
cli-anything-anygen
# Ingresa comandos de forma interactiva con autocompletado e historial
Grupos de comandos
Tarea
Gestión de tareas — crear, consultar, esperar y descargar tareas.
| Comando | Descripción |
|---|---|
create | Crear una tarea de generación |
status | Consultar el estado de una tarea (no bloqueante) |
poll | Esperar hasta que la tarea se complete (bloqueante) |
download | Descargar el archivo generado de una tarea completada |
thumbnail | Descargar la imagen en miniatura de una tarea completada |
run | Flujo de trabajo completo: crear, esperar, descargar |
list | Listar registros de tareas almacenados en caché local |
prepare | Análisis de requisitos en múltiples rondas antes de crear una tarea |
Archivo
Operaciones con archivos — subir archivos de referencia.
| Comando | Descripción |
|---|---|
upload | Subir un archivo de referencia para obtener un file_token |
Configuración
Gestión de configuración — clave API y ajustes.
| Comando | Descripción |
|---|---|
set | Establecer un valor de configuración |
get | Obtener un valor de configuración (o mostrar todos) |
delete | Eliminar un valor de configuración |
path | Mostrar la ruta del archivo de configuración |
Sesión
Gestión de sesión — historial, deshacer, rehacer.
| Comando | Descripción |
|---|---|
status | Mostrar el estado de la sesión |
history | Mostrar el historial de comandos |
undo | Deshacer el último comando |
redo | Rehacer el último comando deshecho |
Ejemplos
Crear un nuevo proyecto
Crea un nuevo archivo de proyecto de anygen.
cli-anything-anygen project new -o myproject.json
# O con salida JSON para uso programático
cli-anything-anygen --json project new -o myproject.json
Sesión REPL interactiva
Inicia una sesión interactiva con soporte para deshacer/rehacer.
cli-anything-anygen
# Ingresa comandos de forma interactiva
# Usa 'help' para ver los comandos disponibles
# Usa 'undo' y 'redo' para navegar por el historial
Gestión de estado
La CLI mantiene el estado de la sesión con:
- Deshacer/Rehacer: Hasta 50 niveles de historial
- Persistencia del proyecto: Guardar/cargar el estado del proyecto como JSON
- Seguimiento de sesión: Registrar modificaciones y cambios
Formatos de salida
Todos los comandos admiten dos modos de salida:
- Legible por humanos (predeterminado): Tablas, colores, texto formateado
- Legible por máquina (bandera
--json): JSON estructurado para consumo por parte del agente
# Salida para humanos
cli-anything-anygen project info -p project.json
# Salida JSON para agentes
cli-anything-anygen --json project info -p project.json
Para agentes de IA
Al usar esta CLI de forma programática:
- Usa siempre la bandera
--jsonpara obtener una salida analizable - Verifica los códigos de retorno — 0 para éxito, distinto de cero para errores
- Analiza stderr para mensajes de error en caso de fallo
- Usa rutas absolutas para todas las operaciones de archivos
- Verifica que las salidas existan después de las operaciones de exportación
Más información
- Documentación completa: Consulta README.md en el paquete
- Cobertura de pruebas: Consulta TEST.md en el paquete
- Metodología: Consulta HARNESS.md en cli-anything-plugin
Versión
1.0.0