| name | bambu-cli |
| description | Operate and troubleshoot BambuLab printers with the bambu-cli (status/watch, print start/pause/resume/stop, files, camera, gcode, AMS, calibration, motion, fans, light, config, doctor). Use when a user asks to control or monitor a BambuLab printer, set up profiles or access codes, or translate a task into safe bambu-cli commands with correct flags, output format, and confirmations. |
Bambu CLI
Overview
Use bambu-cli to configure, monitor, and control BambuLab printers over MQTT/FTPS/camera, producing exact commands and safe defaults.
Defaults and safety
- Confirm the target printer (profile or IP/serial) and resolve precedence: flags > env > project config > user config.
- Avoid access codes in flags; use
--access-code-file or --access-code-stdin only.
- Require confirmation for destructive actions (stop print, delete files, gcode send, calibrate, reboot); use
--force/--confirm only when the user explicitly agrees.
- Offer
--dry-run when supported to preview actions.
- Choose output format: human by default,
--json for structured output, --plain for key=value output.
Quick start
- Configure a profile:
bambu-cli config set --printer <name> --ip <ip> --serial <serial> --access-code-file <path> --default
- Status:
bambu-cli status
- Watch:
bambu-cli watch --interval 5
- Start print:
bambu-cli print start <file.3mf|file.gcode> --plate 1
- Pause/resume/stop:
bambu-cli print pause|resume|stop
- Camera snapshot:
bambu-cli camera snapshot --out snapshot.jpg
Task guidance
Setup & config
- Use
config set/list/get/remove to manage profiles.
- Use env vars to avoid flags in scripts:
BAMBU_PROFILE, BAMBU_IP, BAMBU_SERIAL, BAMBU_ACCESS_CODE_FILE, BAMBU_TIMEOUT, BAMBU_NO_CAMERA, BAMBU_MQTT_PORT, BAMBU_FTP_PORT, BAMBU_CAMERA_PORT.
- Note config locations: user
~/.config/bambu/config.json, project ./.bambu.json.
Monitoring
- Use
status for a one-off snapshot; use watch for periodic updates (--interval, --refresh).
- Use
--json/--plain for scripting.
Printing
- Use
print start <file> with .3mf or .gcode.
- Use
--plate <n|path> to select a plate number or gcode path inside a 3mf.
- Use
--no-upload only when the file already exists on the printer; do not use it with .gcode input.
- Control AMS:
--no-ams, --ams-mapping "0,1", --skip-objects "1,3".
- Disable flow calibration with
--flow-calibration=false if requested.
Files and camera
- Use
files list [--dir <path>], files upload <local> [--as <remote>].
- Use
files download <remote> --out <path|->; use --force to allow writing binary data to a TTY.
- Use
files delete <remote> only with confirmation.
- Use
camera snapshot --out <path|->; use --force to allow stdout to a TTY.
Motion, temps, fans, light
- Use
home, move z --height <0-256>.
- Use
temps get|set (--bed, --nozzle, --chamber; require at least one).
- Use
fans set with --part/--aux/--chamber values 0-255 or 0-1.
- Use
light on|off|status.
Gcode and calibration
- Use
gcode send <line...> or gcode send --stdin (confirmation required; --no-check skips validation).
- Avoid combining
--access-code-stdin with gcode send --stdin; use an access code file instead.
- Use
calibrate with --no-bed-level, --no-motor-noise, --no-vibration when requested.
Troubleshooting
- Use
doctor to check TCP connectivity to MQTT/FTPS/camera ports; suggest --no-camera if the camera port is unreachable.
- Assume default ports: MQTT 8883, FTPS 990, camera 6000 unless configured.
Reference
Read references/commands.md for the full command and flag reference.
