CLI와 앱이 상태를 공유하는 방식
Beam Bench의 에이전트 상태 모델. CLI에서 확인할 수 있는 내용, 앱에서 확인할 수 있는 내용, 그리고 두 영역이 만나는 지점을 설명합니다.
Beam Bench CLI와 데스크톱 앱은 동일한 백엔드를 사용하는 두 클라이언트입니다. 두 클라이언트 모두 동일한 프로젝트, 동일한 머신 연결, 동일한 카메라 상태를 확인할 수 있습니다. 스크립트에서 앱을 제어하려면 두 클라이언트가 상태를 공유하는 방식을 이해하는 것이 유용합니다.
모델
Beam Bench 내부에는 다음을 관리하는 단일 정보 소스가 있습니다.
- 활성 프로젝트
- 머신 연결
- 카메라 상태
- 에이전트 기능 및 상태 인터페이스
데스크톱 앱의 UI는 이 상태를 사용하는 한 소비자입니다. CLI도 또 다른 소비자입니다. HTTP / WebSocket API 역시 동일한 인터페이스를 사용합니다.
CLI에서 할 수 있는 작업
beambench-cli agent state --json는 프로젝트, 머신, 선택 항목, 카메라의 현재 상태를 안정적인 JSON 스키마로 반환합니다. 앱에 현재 로드된 내용을 확인할 때 사용하세요.
beambench-cli agent capabilities --json는 사용 가능한 작업과 각 CLI 하위 명령이 매핑되는 백엔드 작업을 레지스트리 형태로 반환합니다.
beambench-cli agent guide --json는 외부 에이전트(예: Claude)가 앱을 제어하는 방법을 안내하는 워크플로 힌트를 반환합니다.
CLI에서 할 수 없는 작업
CLI에는 자체 UI 상태가 없습니다. 도구를 선택하거나 패널 및 대화 상자를 열 수 없습니다. 이러한 작업은 앱에서 수행해야 하므로 CLI가 아니라 앱에서 실행하세요.
CLI를 실행할 때 앱이 필요한 경우
일부 작업은 앱에서 실제 처리를 수행해야 합니다(오버레이가 포함된 캔버스 렌더링, 카메라 프레임 캡처 등). CLI가 요청을 전달하면 앱이 작업을 수행하고, 결과가 CLI로 다시 전달됩니다.
camera overlay render 명령이 이 방식으로 작동합니다. CLI는 앱이 작업을 완료하거나 시간 초과될 때까지 대기합니다(15 s).
앱이 필요한 명령과 헤드리스 명령
| 앱 실행 필요 여부 | 예시 |
|---|---|
| 아니요(헤드리스) | beambench-cli design render --png, beambench-cli project save, beambench-cli export svg, beambench-cli agent state |
| 예 | beambench-cli camera overlay render, beambench-cli camera capture(네이티브 카메라 사용 시), 모든 UI 상태 검사 |