Uso della CLI

Controlla Beam Bench da un terminale. Apri progetti, esegui il rendering dei canvas, esamina lo stato, esporta file.

Il binario beambench-cli viene compilato insieme all'app Beam Bench. Usalo per script, operazioni in batch e rendering senza interfaccia grafica.

Cosa ti serve

Beam Bench installato (oppure il repository scaricato, se compili dai sorgenti).
Un terminale (Terminal su macOS, PowerShell su Windows, qualsiasi shell su Linux).
Per alcuni comandi: l'app in esecuzione. Per la maggior parte non è necessaria.

Il binario si chiama beambench-cli ed è installato insieme all'app desktop. Il percorso esatto dipende dalla struttura del bundle della piattaforma per la build corrente; controlla la directory di installazione.

Potresti volerlo aggiungere al tuo PATH o assegnargli un alias per abbreviare:

alias bb=beambench-cli

Gli esempi seguenti usano il nome completo beambench-cli.

Passaggi

1. Verifica che la CLI funzioni

beambench-cli --help

Elenca tutti i sottocomandi. Ogni sottocomando ha il proprio --help.

2. Esamina lo stato dell'agente

beambench-cli agent state --json

Restituisce un dump JSON del progetto corrente, della connessione alla macchina, della selezione e dello stato della fotocamera. Utile per script e debug.

3. Esegui il rendering del canvas in PNG (senza interfaccia grafica)

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

Esegue il rendering del design del progetto corrente (senza sovrapposizione della fotocamera) in PNG. Funziona senza che la GUI sia in esecuzione.

4. Esegui il rendering con la sovrapposizione della fotocamera (richiede la GUI)

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

Acquisisce il canvas con il riquadro di sovrapposizione della fotocamera corrente. Richiede che l'app desktop sia in esecuzione; la CLI invia una RPC inversa all'app, che esegue il rendering e scrive il file.

5. Apri un progetto

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

Il percorso è posizionale. Per salvare nuovamente, usa beambench-cli project save (senza argomenti, sovrascrive il file aperto) oppure beambench-cli project save-as /abs/path/to/new.lzrproj.

6. Esporta file

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

Le esportazioni SVG, DXF, PDF, EPS e AI accettano --path. G-code accetta due argomenti posizionali: .lzrproj di input e .gcode di output.

7. Esamina porte / funzionalità

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

agent capabilities restituisce lo schema di ciò che la CLI può fare. agent guide restituisce un flusso di lavoro iniziale per agenti esterni.

Cosa non può fare la CLI

Selezionare uno strumento del canvas.
Aprire o chiudere un pannello / una finestra di dialogo.
Attivare una scorciatoia da tastiera.
Effettuare il trascinamento della selezione sul canvas.

Per queste operazioni, controlla direttamente la GUI (ad es. tramite computer-use o AppleScript), non tramite la CLI.

Esempi

Rendering in batch di ogni progetto in una cartella

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

Acquisisci un'istantanea dello stato della macchina ogni minuto

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

Verifica che abbia funzionato

beambench-cli --help viene eseguito senza errori.
Un comando design render produce un PNG di dimensione non zero.
agent state restituisce JSON valido.