¿Qué hace cli-anything-seaclip?
Una interfaz de línea de comandos sin estado para la gestión de proyectos de SeaClip-Lite. Se comunica a través de API HTTP y lecturas directas de SQLite. Sin estado ni sesión local.
Instalación
pip install -e .
Prerrequisitos:
- Python 3.10+
- Backend SeaClip-Lite ejecutándose en localhost:5200
Uso
Comandos básicos
# Mostrar ayuda
cli-anything-seaclip --help
# Iniciar modo REPL interactivo
cli-anything-seaclip
# Ejecutar con salida JSON (para consumo por agentes)
cli-anything-seaclip --json server health
cli-anything-seaclip --json issue list
cli-anything-seaclip --json agent list
Modo REPL
Cuando se invoca sin un subcomando, la CLI inicia una sesión REPL interactiva:
cli-anything-seaclip
# Introduzca comandos interactivamente con autocompletado y historial
Grupos de comandos
issue (Incidencias)
Comandos de gestión de incidencias.
| Comando | Descripción |
|---|---|
list | Listar incidencias (--status, --priority, --search, --limit) |
create | Crear una nueva incidencia (--title, --description, --priority) |
move | Mover incidencia a columna (ISSUE_ID --column COL) |
status | Actualizar estado de incidencia (ISSUE_ID --set STATUS) |
delete | Eliminar una incidencia (ISSUE_ID) |
agent (Agentes)
Comandos de agentes del pipeline.
| Comando | Descripción |
|---|---|
list | Listar todos los agentes del pipeline |
pipeline (Pipeline)
Comandos de control del pipeline.
| Comando | Descripción |
|---|---|
start | Iniciar pipeline (--issue UUID --mode auto/manual) |
status | Obtener estado del pipeline (--issue UUID) |
resume | Reanudar pipeline pausado (--issue UUID) |
stop | Detener pipeline en ejecución (--issue UUID) |
scheduler (Programador)
Comandos de configuración de programación.
| Comando | Descripción |
|---|---|
list | Listar todas las configuraciones de programación |
add | Agregar programación (--name, --cron, --repo) |
sync | Activar sincronización (SCHEDULE_ID) |
activity (Actividad)
Comandos del feed de actividad.
| Comando | Descripción |
|---|---|
list | Actividad reciente (--limit N) |
server (Servidor)
Comandos de utilidad del servidor.
| Comando | Descripción |
|---|---|
health | Comprobar estado del backend |
Formatos de salida
Todos los comandos soportan modos de salida dual:
- Legible para humanos (por defecto): Tablas, colores, texto formateado
- Legible para máquinas (flag
--json): JSON estructurado para consumo por agentes
# Salida legible para humanos
cli-anything-seaclip issue list
# Salida JSON para agentes
cli-anything-seaclip --json issue list
Para agentes de IA
Al usar esta CLI de forma programática:
- Use siempre el flag
--jsonpara salida analizable - Verifique los códigos de retorno - 0 para éxito, distinto de cero para errores
- Analice stderr para mensajes de error en caso de fallo
- Respuestas de error incluyen
{"error": "mensaje"}en modo JSON
Versión
1.0.0