De CLI gebruiken

Bedien Beam Bench vanuit een terminal. Open projecten, render canvassen, bekijk de status en exporteer bestanden.

Het binaire bestand beambench-cli wordt samen met de Beam Bench-app gebouwd. Gebruik het voor scripting, batchbewerkingen en headless rendering.

Wat je nodig hebt

Beam Bench geïnstalleerd (of de repository uitgecheckt als je vanuit de broncode bouwt).
Een terminal (Terminal op macOS, PowerShell op Windows of een willekeurige shell op Linux).
Voor sommige opdrachten: de app moet actief zijn. Voor de meeste opdrachten is dat niet nodig.

Het binaire bestand heet beambench-cli en wordt naast de desktopapp geïnstalleerd. Het exacte pad hangt af van de bundelindeling van het platform voor je huidige build; controleer de installatiemap.

Je kunt het op je PATH zetten of er een alias voor maken:

alias bb=beambench-cli

In de onderstaande voorbeelden wordt de volledige naam beambench-cli gebruikt.

Stappen

1. Controleer of de CLI werkt

beambench-cli --help

Toont alle subopdrachten. Elke subopdracht heeft een eigen --help.

2. Bekijk de status van de agent

beambench-cli agent state --json

Geeft een JSON-dump terug van het huidige project, de machineverbinding, de selectie en de camerastatus. Handig voor scripting en foutopsporing.

3. Render het canvas naar een PNG (headless)

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

Rendert het ontwerp van het huidige project (zonder camera-overlay) naar een PNG. Werkt zonder dat de GUI actief is.

4. Render met camera-overlay (GUI vereist)

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

Legt het canvas vast met het huidige camera-overlaykader. De desktopapp moet actief zijn; de CLI stuurt een reverse-RPC naar de app, die de rendering uitvoert en het bestand schrijft.

5. Open een project

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

Het pad is positioneel. Gebruik beambench-cli project save (zonder argumenten; overschrijft het geopende bestand) of beambench-cli project save-as /abs/path/to/new.lzrproj om het bestand terug op te slaan.

6. Exporteer bestanden

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

Voor SVG-, DXF-, PDF-, EPS- en AI-export gebruik je --path. Voor G-code zijn twee positionele argumenten nodig: invoer .lzrproj en uitvoer .gcode.

7. Bekijk poorten en mogelijkheden

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

agent capabilities geeft het schema terug van wat de CLI kan doen. agent guide geeft een opstartworkflow voor externe agents terug.

Wat de CLI niet kan doen

Een canvashulpmiddel selecteren.
Een paneel of dialoogvenster openen of sluiten.
Een sneltoets activeren.
Slepen en neerzetten op het canvas.

Gebruik hiervoor rechtstreeks de GUI (bijvoorbeeld via computer use of AppleScript), niet de CLI.

Voorbeelden

Elk project in een map batchgewijs renderen

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

Elke minuut een momentopname van de machinestatus maken

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

Controleer of het is gelukt

beambench-cli --help wordt zonder fout uitgevoerd.
design render produceert een PNG met een niet-nul bestandsgrootte.
agent state geeft geldige JSON terug.