Roasting
CLI roast commands
Create roast profiles, import Artisan files, and set up folder watching from the terminal.
Roast commands turn terminal workflows into operational tools. They are especially useful for importing Artisan .alog files and automating roast capture with folder watching.
The CLI encourages purvey roast import when an .alog file is available, extracting curves, events, and milestone timing automatically.
Commands
- purvey roast list: list profiles, optionally filtered by --coffee-id, --roast-id, --batch-name, --coffee-name, --catalog-id, --date-start, or --date-end.
- purvey roast get <id>: fetch a single roast profile (--include-temps, --include-events for full telemetry).
- purvey roast create: create a roast record manually.
- purvey roast import: import an Artisan .alog file.
- purvey roast update <id>: update notes, batch name, oz-out, or targets on an existing profile.
- purvey roast delete <id>: delete a roast profile.
- purvey roast watch: watch a directory for new .alog files with --coffee-id, --batch-prefix, --prompt-each, or --auto-match, and resume long-running sessions with --resume.
Create, import, list, update, and watch
purvey roast create --coffee-id 7 --batch-name "Ethiopia Guji Light" --oz-in 16 --pretty
purvey roast import ~/artisan/ethiopia-guji.alog --coffee-id 7 --pretty
purvey roast list --roast-id 123 --pretty
purvey roast list --batch-name "Guji" --pretty
purvey roast list --catalog-id 128 --pretty
purvey roast update 123 --targets "Aim for FC at 390F, 18% dev"
purvey roast watch ~/artisan/ --auto-match
purvey roast watch --resumeBehavior notes
- --coffee-id always refers to green_coffee_inv.id (use purvey inventory list to find IDs), while --catalog-id on roast list cross-references the underlying coffee_catalog row.
- --roast-id filters by the exact roast profile ID while keeping the list output shape, which is useful in scripts that already expect arrays.
- Import extracts roast curves, events, and milestone timing from .alog files.
- Interactive file and directory prompts normalize pasted path input: surrounding quotes are removed, shell-escaped spaces and common special characters are unescaped, and Windows or UNC path separators are preserved.
- Interactive --form mode provides a guided workflow for create, import, and watch setup. On roast watch, --auto-match and --coffee-id are mutually exclusive, session state is saved for --resume, and the command runs until interrupted.