bambu-cli

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