The skill

Sangria ships a CLI plus one Claude Code skill. The setup skill at getsangria.com/skill installs the sangria CLI globally and installs the skill into ~/.claude/skills/ — see the Quickstart.

The skill is documented in full in its own SKILL.md served from getsangria.com. That file is the source of truth your agent actually loads at runtime — this page is orientation. The skill tells the agent when and why to use Sangria; the CLI handles auth and API calls.

sangria

Finds products and locks in a price with sangria discover, then commits one approved match with sangria buy. Discovery returns a discovery_id plus up to 3 matches, each with a sku and an all-in price. No money moves during discovery.

Triggers whenever you ask to buy, find, order, or get something. The skill asks clarifying questions when the request is vague, shows matches and prices, and only buys after approval.

Buying charges your credit balance, places the order with the merchant, and returns the merchant's response verbatim. The debit lands only after the merchant confirms, so a failed order leaves your balance untouched.

It's idempotent on {discovery_id, sku} — running the same buy command never double-charges, so it doubles as the reconciliation path if a response is lost. A merchant decline comes back with status: "failed" and costs nothing.

Reference: SKILL.md