Security

marlinfw-tools

Try it

Inspects and carefully controls a USB-connected Marlin 3D printer (Creality Ender 3 and similar) through a locked-down Docker container: discovers stable serial paths, reads firmware, M503 settings, temperatures, position and endstops, records JSONL telemetry, lists SD card files, homes under supervision, applies one audited calibration setting, and runs a supervised first-layer SD test. Use when the user wants to read, calibrate, home or monitor a Marlin printer over serial.

What it does

All operations go through , relative to this skill's directory. It runs the image with , a read-only root, all capabilities dropped, and only the one serial device you name. Set to use a different image, for example after in a checkout of the repository.

The skill document

Marlin printer tools

All operations go through scripts/marlinfw-tools.sh, relative to this skill's directory. It runs the psyb0t/marlinfw-tools:latest image with --network=none, a read-only root, all capabilities dropped, and only the one serial device you name. Set MARLINFW_TOOLS_IMAGE to use a different image, for example marlinfw-tools:dev after make build in a checkout of the repository.

Security & safety

  • Start with discover and use the stable /dev/serial/by-id/... path it returns. Never guess /dev/ttyUSB0 or pass the whole /dev tree.
  • discover, inspect, sd-files and record only read printer state. Use them freely.
  • home, send and sd-print-monitor change physical printer state. Before each one, get the user's approval in the current turn for the exact printer path, command and expected physical effect, and whether it should survive a reboot. Never infer permission from an earlier request to inspect or calibrate. The --apply --confirm-risk flags are an execution gate, not a substitute for that approval.
  • home and sd-print-monitor also need --confirm-supervised: the user must be at the printer with the power switch in reach.
  • Serial telemetry cannot judge nozzle clearance, extrusion, adhesion, smoke or collisions. Never report physical safety from it.
  • On firmware that reports Cap:EMERGENCY_PARSER:0, serial M524 cannot interrupt a blocking M190, M109 or homing command. The user's physical stop is the only fast stop.
  • The tool never sends movement, heating, leveling, pin control, emergency stop, EEPROM load or reset, firmware update or arbitrary G-code. send accepts only M92, M201, M203, M204, M205, M206, M301 and M304.

When to use

  • Find a printer's serial path and identify its Marlin firmware and capabilities.
  • Back up active settings (M503) or read temperatures, position and endstops.
  • Record temperatures, position, endstops and SD status as JSONL while the user works.
  • List the exact SD card filenames Marlin sees.
  • Home once under supervision, apply one measured calibration value, or run the supervised first-layer test.

When NOT to use

  • Klipper or Moonraker printers, or a printer that should be driven through OctoPrint's network API.
  • Guessing calibration values, running arbitrary G-code, flashing firmware, factory resets, or changing a printer mid-print.

Read the printer

scripts/marlinfw-tools.sh discover

scripts/marlinfw-tools.sh inspect \
  --port /dev/serial/by-id/replace-with-printer-path \
  | tee printer-inspect.json

inspect sends M115, M503, M105, M114 and M119. Keep printer-inspect.json: it is the rollback baseline for any later change. See Marlin reports for what each section means and device access when the device is missing or busy.

scripts/marlinfw-tools.sh sd-files --port /dev/serial/by-id/replace-with-printer-path

scripts/marlinfw-tools.sh record --port /dev/serial/by-id/replace-with-printer-path \
  | tee printer-events.jsonl

record runs until Ctrl+C, or pass --duration 300 for five minutes. It never starts, pauses or stops a print.

Home

After approval and with the user at the machine, the bed and toolhead path clear and no print active:

scripts/marlinfw-tools.sh home --port /dev/serial/by-id/replace-with-printer-path \
  --apply --confirm-risk --confirm-supervised

It sends exactly G28, M114 and M119. Run it once and report the returned position and endstops.

Change one setting

  1. Run inspect and keep the JSON as the baseline.

  2. Get the user's physical measurement and the parameter it calibrates. Never derive a value from a guess.

  3. Calculate one command and show the exact port, command and expected effect.

  4. After approval, apply it for this power cycle only:

    scripts/marlinfw-tools.sh send --port /dev/serial/by-id/replace-with-printer-path \
      --command 'M92 E' --apply --confirm-risk
    
  5. Run inspect again and compare the relevant line.

  6. Only after a second, separate approval, persist it. This adds M500 once the setting is acknowledged:

    scripts/marlinfw-tools.sh send --port /dev/serial/by-id/replace-with-printer-path \
      --command 'M92 E' --apply --confirm-risk --save --confirm-persist
    

Read setting writes before any --save, and Creality Ender 3 before changing anything on an Ender 3 family printer.

Supervised first-layer test

Starts one exact SD file, waits through heating and homing, records the first-layer motion, then aborts the job and turns both heaters off:

scripts/marlinfw-tools.sh sd-print-monitor --port /dev/serial/by-id/replace-with-printer-path \
  --file REPLACE.GCO --observe-seconds 60 \
  --apply --confirm-risk --confirm-supervised \
  | tee first-layer-events.jsonl

Use a filename exactly as sd-files reported it.

Completion

  • Inspection: every requested command returned a response or an explicit firmware error. Report unresolved access or unsupported commands; never fill in a guessed value.
  • Temporary change: Marlin acknowledged the command and a follow-up inspect shows the expected value.
  • Persistent change: a second approval, an acknowledged M500, and before-and-after reports kept.
  • First-layer test: motion was detected and M524, M104 S0, M140 S0 and M155 S0 were all acknowledged. If cleanup is not confirmed, say which command failed and tell the user to make the printer safe by hand.

Related skills

Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.

by nssa.io1.0k installs47 stars

Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.

by Iván561 installs18 stars

Fetch raw ad creative, app, ranking, and revenue data from AdMapix as structured JSON.

by fly0pants4.3k installs296 stars

Find why your productivity system keeps failing, then apply the smallest fix — capacity math, bottleneck routing, durable local notes.

by Iván857 installs69 stars

Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.

by johnpatternai22 installs8 stars

More from psyb0t

Browse all skills

Drive a user-deployed mt5-httpapi MetaTrader 5 bridge over HTTP, with per-action confirmation on every real-money call.

by psyb0t108 installs4 stars

Docker-packaged browser automation for QA against anti-bot stacks and authorized detection testing.

by psyb0t138 installs2 stars

Self-hosted OpenAI-compatible speech service — transcription, translation, and synthesis from one container.

by psyb0t13 installs

Run ffmpeg, sox, and ImageMagick jobs against your files in a fixed-allowlist SSH sandbox.

by psyb0t71 installs

Generate speech audio via Qwen3-TTS over SSH with preset voices, voice cloning, and voice design.

by psyb0t55 installs

Drive one or more IMAP/SMTP mailboxes through a single REST + MCP endpoint — read, search, send, mark-seen, and delete across accounts in parallel.

by psyb0t15 installs