CLI 사용

터미널에서 Beam Bench를 제어합니다. 프로젝트를 열고, 캔버스를 렌더링하고, 상태를 확인하고, 파일을 내보낼 수 있습니다.

beambench-cli 바이너리는 Beam Bench 앱과 함께 빌드됩니다. 스크립팅, 일괄 작업, 헤드리스 렌더링에 사용할 수 있습니다.

필요한 항목

Beam Bench가 설치되어 있어야 합니다(소스에서 빌드하는 경우에는 리포지토리를 체크아웃해야 합니다).
터미널(macOS의 Terminal, Windows의 PowerShell, Linux의 셸).
일부 명령의 경우 앱이 실행 중이어야 합니다. 대부분의 명령에는 필요하지 않습니다.

CLI 위치

바이너리 이름은 beambench-cli이며 데스크톱 앱과 함께 설치됩니다. 정확한 경로는 현재 빌드의 플랫폼별 번들 구조에 따라 달라지므로 설치 디렉터리를 확인하세요.

간편하게 사용하려면 PATH에 추가하거나 별칭을 지정할 수 있습니다.

alias bb=beambench-cli

아래 예제에서는 전체 beambench-cli 이름을 사용합니다.

단계

1. CLI 작동 확인

beambench-cli --help

모든 하위 명령을 나열합니다. 각 하위 명령에는 고유한 --help가 있습니다.

2. 에이전트 상태 확인

beambench-cli agent state --json

현재 프로젝트, 머신 연결, 선택 항목 및 카메라 상태를 JSON 덤프로 반환합니다. 스크립팅과 디버깅에 유용합니다.

3. 캔버스를 PNG로 렌더링(헤드리스)

beambench-cli design render --png /tmp/out.png --pixels-per-mm 4

현재 프로젝트의 디자인을 카메라 오버레이 없이 PNG로 렌더링합니다. GUI가 실행 중이 아니어도 작동합니다.

4. 카메라 오버레이와 함께 렌더링(GUI 필요)

beambench-cli camera overlay render --output /tmp/overlay.png --view fit

현재 카메라 오버레이 프레임이 포함된 캔버스를 캡처합니다. 데스크톱 앱이 실행 중이어야 하며, CLI가 앱에 reverse-RPC를 보내면 앱이 렌더링을 수행하고 파일을 씁니다.

5. 프로젝트 열기

beambench-cli project open /abs/path/to/project.lzrproj

경로는 위치 인수입니다. 다시 저장하려면 beambench-cli project save(인수 없음, 열린 파일을 덮어씀)를 사용하거나 beambench-cli project save-as /abs/path/to/new.lzrproj를 사용하세요.

6. 파일 내보내기

beambench-cli export svg --path /abs/path/out.svg
beambench-cli export gcode /abs/path/to/project.lzrproj /abs/path/out.gcode

SVG, DXF, PDF, EPS 및 AI 내보내기에는 --path가 필요합니다. G-code에는 위치 인수 두 개가 필요합니다. 입력 .lzrproj와 출력 .gcode입니다.

7. 포트 및 기능 확인

beambench-cli ports
beambench-cli agent capabilities --json
beambench-cli agent guide --json

agent capabilities는 CLI에서 수행할 수 있는 작업의 스키마를 반환합니다. agent guide는 외부 에이전트를 위한 부트스트랩 워크플로를 반환합니다.

CLI로 할 수 없는 작업

캔버스 도구 선택
패널 또는 대화 상자 열기 및 닫기
단축키 실행
캔버스에서 드래그 앤 드롭

이러한 작업은 CLI가 아니라 GUI를 직접 제어하세요(예: computer-use 또는 AppleScript 사용).

예제

폴더의 모든 프로젝트 일괄 렌더링

for f in /path/to/projects/*.lzrproj; do
  beambench-cli project open "$f"
  beambench-cli design render --png "${f%.lzrproj}.png" --pixels-per-mm 4
done

1분마다 머신 상태 스냅샷 생성

while true; do
  beambench-cli agent state --json > "/tmp/state-$(date +%s).json"
  sleep 60
done

작동 여부 확인

beambench-cli --help가 오류 없이 실행됩니다.
design render가 크기가 0이 아닌 PNG를 생성합니다.
agent state가 유효한 JSON을 반환합니다.