Saltar al contenido
Kira LOCAL-FIRST
CLI para operadores y agentes

Usá la CLI para flujos repetibles de cards y topic inbox.

La CLI editorial es un proceso one-shot: cada comando abre SQLite, hace una transacción, imprime y sale. Eso la vuelve segura para automatización y scripts controlados.

Versión en simple

La mayoría de streamers no necesita la CLI. Es para operadores, scripts y agentes que preparan cards o sugerencias de topics de forma repetible.

Flujo seguro con CLI

1

Preparar

Una persona, script o agente crea una card chica o propuesta de topic.

2

Validar

La CLI acepta solo input acotado y curado, con errores claros.

3

Revisar

Las propuestas de topic todavía necesitan revisión humana en la app.

4

Usar en vivo

El contenido aprobado puede asistir a Kira durante el stream.

Camino rápido

  1. 1 Corré los comandos desde la raíz del repo o desde el entorno Python empaquetado.
  2. 2 Usá --json para agentes y parseá stderr cuando el exit code sea distinto de cero.
  3. 3 Tratá exit 1 como un resultado decidido de validación/estado, no como algo para reintentar a ciegas.
  4. 4 Reintentá solo fallos transitorios "database is locked", con backoff.

Quién debería usarla

Streamer

Usá primero la UI de la app. Es el camino más seguro y claro para operar en vivo.

Operador

Usá la CLI para preparar muchas cards o propuestas antes del show.

Agente/script

Usá --json, revisá exit codes y nunca asumas que un topic quedó aprobado.

Comandos comunes

Crear una card

python -m opencohost.editorial_cli --json create --from-json

Armar e inspeccionar

python -m opencohost.editorial_cli arm <card_id>
python -m opencohost.editorial_cli show <card_id> --json

Link explícito de card

python -m opencohost.editorial_cli link <topic_slug> <card_id>

Proponer un topic

python -m opencohost.editorial_cli topic propose --title "<title>" --angle "<angle>" --source "<agent>"

Listar o descartar propuestas

python -m opencohost.editorial_cli topic list --json
python -m opencohost.editorial_cli topic discard <ti_id>

Límites duros

No hay aprobación de topics por CLI
topic approve se rechaza a propósito. La aprobación ocurre en la app, donde el operador puede leer título y ángulo.
Solo contexto curado
Las cards rechazan dumps crudos, contenido tipo código y campos demasiado grandes. Los agentes deben resumir antes de escribir.
Una operación por proceso
No hay daemon ni memoria de sesión en la CLI; el orden de comandos es la máquina de estados.