Member workflows
CLI inventory commands
List, add, update, and delete green coffee inventory from your terminal. Requires authentication.
Inventory commands manage your green coffee inventory, the same data visible on the /beans page in the web app. Results include catalog details joined to your inventory records.
Inventory IDs are distinct from catalog IDs. Roast commands and other workflows expect inventory IDs.
Commands
- purvey inventory list: list inventory with optional filters including --stocked, --catalog-id, --origin, --purchase-date-start, --purchase-date-end, and --limit.
- purvey inventory get <id>: fetch a single inventory item by ID.
- purvey inventory add: add a new inventory item (--catalog-id and --qty are required).
- purvey inventory update <id>: update fields on an existing inventory item.
- purvey inventory delete <id>: delete an item; --force cascades to dependent roast profiles and sales.
List, add, update, and export
purvey inventory list --stocked --pretty
purvey inventory list --origin Ethiopia --pretty
purvey inventory list --catalog-id 128 --pretty
purvey inventory list --purchase-date-start 2026-01-01 --purchase-date-end 2026-03-31
purvey inventory add --catalog-id 128 --qty 10 --cost 8.50 --pretty
purvey inventory update 7 --stocked false
purvey inventory delete 7 --yes
purvey inventory delete 7 --force --yes
purvey inventory list --limit 50 --csv > inventory.csvadd and update flags
- add required flags: --catalog-id (catalog entry ID), --qty (pounds).
- add optional flags: --cost, --tax-ship, --notes, --purchase-date, --form.
- update fields: --qty, --cost, --tax-ship, --notes, --stocked <true|false>.
- delete --force cascades to dependent roast profiles and sales records. Without --force, delete fails if dependents exist.
Important
Use inventory IDs for roast work
purvey roast --coffee-id expects green_coffee_inv.id values. Do not pass coffee_catalog IDs into roast commands.