Everyday commands
The commands you'll use most, with examples.
Updated October 31, 2026
Commands follow cost <group> <action>. Every one has --help, for example cost documents list --help, and the Reference lists them all.
Find anything
cost search all "tri-state"
cost search all "sheetrock" --types material
Documents
cost documents list --status needs_attention # waiting on you
cost documents list --type invoice --since 2026-10-01 # this month's invoices
cost documents list --supplier-id <id> --sort total # one supplier, biggest first
cost documents get <document-id> # header, line items, price checks
cost documents search 539295 # by number, file name, or address
cost documents counts # how many in each status
Suppliers and projects
cost suppliers list
cost suppliers get <supplier-id>
cost suppliers materials <supplier-id> --search pex
cost projects list
cost projects get <project-id>
Materials and prices
cost materials find "5/8 sheetrock" # by description, not exact words
cost materials history <material-id> --since 2026-01-01
cost materials prices <material-id> # your history vs. other suppliers vs. online
Spend
cost spend monthly
cost spend categories
IDs come from earlier results: list, find, and search show them, and --json always includes them.
Didn't answer your question?
Email [email protected]