filament-vault

# filament-vault Local filament inventory tracker. All data stored in JSON at `~/.openclaw/workspace/filament-vault/inventory.json`. ## Scripts All scripts live in `scripts/`. Run with `python3 scripts/<script>.py [args]`. ## Add a Spool ``` python3 scripts/add_spool.py --brand "Bambu" --material PLA --color "Matte Black" --weight 1000 --cost 19.99 --location "Shelf A" ``` Options: `--brand`, `--material` (PLA/PETG/ABS/TPU/Nylon/ASA/other), `--color`, `--weight` (grams, default 1000), `--cost` (USD), `--location`, `--notes` ## Update / Use a Spool ``` python3 scripts/update_spool.py --search "matte black" --used 150 python3 scripts/update_spool.py --id <uuid> --finished --notes "Ran out mid-print" ``` Options: `--id` (UUID), `--search` (partial match), `--used` (grams consumed), `--finished` (mark empty), `--notes` ## List Inventory ``` python3 scripts/inventory.py python3 scripts/inventory.py --material PLA --low-stock python3 scripts/inventory.py --json ``` Filters: `--material`, `--color`, `--brand`, `--low-stock` (under threshold, default 100g), `--threshold <g>`, `--json` ## Generate Report ``` python3 scripts/report.py python3 scripts/report.py --threshold 200 ``` Shows: total spools, total weight, total value, by-material breakdown, low-stock alerts, monthly spending. ## Search ``` python3 scripts/search.py "bambu" python3 scripts/search.py "black petg" --json ``` Fuzzy search across all fields (brand, color, material, location, notes). ## References See `references/materials.md` for filament material properties and guidance.