Cómo comparten el estado la CLI y la aplicación
Modelo de estado del agente de Beam Bench. Qué ve la CLI, qué ve la aplicación y dónde se conectan.
La CLI de Beam Bench y la aplicación de escritorio son dos clientes del mismo backend. Ambas pueden consultar el mismo proyecto, la misma conexión con la máquina y el mismo estado de la cámara. Saber cómo comparten ese estado resulta útil cuando quieres controlar la aplicación mediante un script.
El modelo
Beam Bench dispone de una única fuente de información que gestiona:
- El proyecto activo.
- La conexión con la máquina.
- El estado de la cámara.
- La interfaz de capacidades y estado del agente.
La interfaz de usuario de la aplicación de escritorio consume ese estado. La CLI también. La API HTTP / WebSocket ofrece la misma interfaz.
Qué puede hacer la CLI
beambench-cli agent state --json devuelve el estado actual del proyecto, la máquina, la selección y la cámara mediante un esquema JSON estable. Úsalo para consultar qué tiene cargado la aplicación en ese momento.
beambench-cli agent capabilities --json devuelve un registro de las operaciones disponibles y qué subcomandos de la CLI corresponden a cada operación del backend.
beambench-cli agent guide --json devuelve indicaciones sobre el flujo de trabajo para que un agente externo, como Claude, controle la aplicación.
Qué no puede hacer la CLI
La CLI no tiene un estado de interfaz de usuario propio. No puede seleccionar una herramienta, abrir un panel ni abrir un cuadro de diálogo. Estas acciones corresponden a la aplicación. Hazlas desde ella, no desde la CLI.
Cuándo necesita la CLI que la aplicación esté en ejecución
Algunas operaciones requieren que la aplicación realice el trabajo, como renderizar el lienzo con la superposición o capturar un fotograma de la cámara. La CLI envía la solicitud, la aplicación realiza el trabajo y el resultado vuelve a la CLI.
El comando camera overlay render funciona de esta forma. La CLI queda bloqueada hasta que la aplicación termina o se agota el tiempo de espera (15 s).
Comandos sin interfaz y comandos que necesitan la aplicación
| ¿Debe estar ejecutándose la aplicación? | Ejemplos |
|---|---|
| No (sin interfaz) | beambench-cli design render --png, beambench-cli project save, beambench-cli export svg, beambench-cli agent state |
| Sí | beambench-cli camera overlay render, beambench-cli camera capture (al usar la cámara nativa), cualquier consulta del estado de la interfaz de usuario |