# Purveyors documentation

> Product, catalog methodology, CLI, and AI agent documentation for Purveyors. Every page below is plain Markdown.

AI agents: to install the Purveyors CLI, sign in, and add the Purveyors skill, follow https://www.purveyors.io/docs/agents/setup.md

Parchment API reference (OpenAPI): https://api.purveyors.io/docs

All pages in one file: https://www.purveyors.io/llms-full.txt

## Catalog methodology

Buyer-facing methodology for Purveyor Score, metadata quality, and catalog trust signals.

- [Purveyor Score](https://www.purveyors.io/docs/catalog/purveyor-score.md): How Purveyors scores listing metadata depth, structure, buyer usefulness, and confidence.

## CLI docs

Install, authenticate, and use the Purveyors CLI for catalog queries, inventory, roasting, scripting, and agent automation.

- [Overview](https://www.purveyors.io/docs/cli/overview.md): Install, authenticate, and explore the CLI command structure.
- [Auth, config, and output](https://www.purveyors.io/docs/cli/auth-output.md): Sign-in, roles, settings, output modes, exit codes, and IDs.
- [Catalog commands](https://www.purveyors.io/docs/cli/catalog.md): Search, rank, and compare green coffees and suppliers.
- [Inventory commands](https://www.purveyors.io/docs/cli/inventory.md): List and manage your green coffee inventory.
- [Roast commands](https://www.purveyors.io/docs/cli/roast.md): Record roasts, import and download Artisan files, and watch folders.
- [Roast batch commands](https://www.purveyors.io/docs/cli/roast-batch.md): List, open, rename, and delete roast batches by ID.
- [Sales commands](https://www.purveyors.io/docs/cli/sales.md): Record and update roasted-coffee sales.
- [Tasting commands](https://www.purveyors.io/docs/cli/tasting.md): Read supplier notes and record your own cupping scores.
- [Agent skill commands](https://www.purveyors.io/docs/cli/skill.md): Print or install the Purveyors skill for AI agents.
- [Market commands](https://www.purveyors.io/docs/cli/market.md): Value signals, price movement, trends, and evidence.
- [Price index commands](https://www.purveyors.io/docs/cli/price-index.md): Price snapshots, 30-day comparisons, and chart history.
- [Procurement commands](https://www.purveyors.io/docs/cli/procurement.md): Read saved sourcing briefs and their catalog matches.
- [Reference profile commands](https://www.purveyors.io/docs/cli/reference-profile.md): Compare, plan from, export, and download saved references.
- [Context and manifest](https://www.purveyors.io/docs/cli/context-manifest.md): Readable reference text and the machine-readable command contract.
- [Agent integration](https://www.purveyors.io/docs/cli/agent-integration.md): Give AI agents reliable access to your coffee data through the CLI.

## Agent setup

Connect an AI agent to your Purveyors account: install the CLI, approve sign-in in your browser, and add the Purveyors skill.

- [Set up your agent](https://www.purveyors.io/docs/agents/setup.md): Step-by-step instructions an AI agent can follow on your behalf.