diff --git a/CHANGELOG.md b/CHANGELOG.md index da09c22..39dc54e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,12 @@ All notable changes to this project are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [Unreleased] + +### Changed +- README opens with why the tool exists: agents can sweep orientations, print sequences and tower options in + parallel and iterate on plates in a way a person in the Studio GUI cannot; Studio stays the final pass. + ## [0.6.0] - 2026-10-29 A shambu project now opens in Bambu Studio with the process it was sliced with. On 2026-10-29 the owner opened a diff --git a/README.md b/README.md index a15189b..d4a6da0 100644 --- a/README.md +++ b/README.md @@ -5,6 +5,15 @@ [![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) ![python](https://img.shields.io/badge/python-3.11%2B-blue) +**Why this exists.** Bambu Studio is a one-plate-at-a-time tool: you arrange, pick a profile, slice, read the +estimate, and try again. Every variant costs a human a few minutes, so nobody explores more than a handful. shambu +turns that loop into a command an agent can run many times over, in parallel: the same parts in six orientations, +by object and by layer, with and without a prime tower, on one plate or two, each slice read back as grams and +minutes (`shambu sweep` does exactly this). Because it ships as a Claude Code skill, several agents can prepare +several plates at once, each with its own placement and reach checks, and iterate on the result in a way a person +in the GUI cannot. Studio stays the place where you look at the plate and press Print; the search for the best plate +happens before that, at machine speed, with every rule the slicer enforces checked first. + STLs in, a checked Bambu Studio project out. `shambu` drives Bambu Studio's own command line to turn a short JSON spec into a `.3mf` project (or a sliced `.gcode.3mf` with time and filament estimates) with the parts placed, the process settings applied, the right filament on each part and the plate type set. It also inspects and