# peer-cli

- [peer-cli Docs](/docs): Agent-first documentation for the Peer protocol CLI and MCP server.
- Guide: Execution model, safety, config, auth, and output behavior.
  - [Guide](/docs/guide): How agents should reason about peer-cli before they touch any command.
  - [Install and Runtime](/docs/guide/install-runtime): Runtime prerequisites, local entrypoints, and the difference between source execution and the built artifact.
  - [Configuration](/docs/guide/configuration): Config precedence, persistent files, wallet resolution, and what auth each command family expects.
  - [Execution Model](/docs/guide/execution-model): Preview-first writes, parameter merging, CLI vs MCP behavior, and safe command construction.
  - [Output and Errors](/docs/guide/output-errors): The CLI output envelope, metadata fields, table-vs-JSON behavior, and canonical error taxonomy.
- Reference: Command families, MCP, and machine-readable artifacts.
  - [Reference](/docs/reference): Command-family map and how the surface is divided for operators and agents.
  - [Quotes, Payees, and Taker State](/docs/reference/quotes-payees): The entry surface for pricing, payee details, hash resolution, and taker capacity checks.
  - [Deposits](/docs/reference/deposits): Deposit lifecycle, funding, liquidity tuning, payment method management, currencies, oracle config, and delegate binding.
  - [Protocol Reads and Intents](/docs/reference/protocol-reads-intents): When to use ProtocolViewer, when to use indexer reads, and how intent creation, cancellation, fulfillment, and hooks fit together.
  - [Vaults and Delegation](/docs/reference/vaults-delegation): Vault creation and pricing control, manager-level reads, oracle helpers, and both controller-based and direct delegation paths.
  - [Market, Funds, and Checkout](/docs/reference/market-funds-checkout): Analytics endpoints, direct wallet transfers, balance checks, and checkout session lifecycle operations.
  - [MCP](/docs/reference/mcp): How the stdio server is exposed, how tool names are generated, and how agents should reason about read-only vs full mode.
  - [Catalogs and Sync](/docs/reference/catalogs): Machine-readable artifacts, their purpose, and how they are regenerated from the command registry.
- Playbooks: Goal-oriented workflows for agents and operators.
  - [Playbooks](/docs/playbooks): Goal-oriented flows that combine discovery, preview, execution, and verification.
  - [Quote and Payee Resolution](/docs/playbooks/quote-and-payee-resolution): Recommended flow when an agent starts from a fiat amount and needs a viable quote plus payee state.
  - [Deposit Lifecycle](/docs/playbooks/deposit-lifecycle): A disciplined sequence for creating, funding, tuning, and maintaining a deposit.
  - [Vault and Delegation](/docs/playbooks/vault-and-delegation): Safe workflow for vault creation, pricing changes, and delegation updates.
  - [Checkout and Cache](/docs/playbooks/checkout-and-cache): Creating, reviewing, canceling, and reconciling checkout sessions with awareness of the local cache.
  - [Troubleshooting](/docs/playbooks/troubleshooting): What to inspect next when a peer-cli workflow fails or produces unexpected output.