# Docs

Every link below serves clean markdown. Fetch the one page you need.
The whole corpus in one file is at /llms-full.txt (large: read a single page first).

- [Documentation](/docs.md): Build and operate a paid HTTPS service, or use one, with an agent.

- **Build**
- [Build a DVM](/docs/build.md): Build, test, deploy, and operate a paid HTTPS capability with dvmctl.
- [Builder quickstart](/docs/build-quickstart.md): Install dvmctl and the complete builder skill, then hand it a concrete service brief.
- [Capabilities](/docs/builder-capabilities.md): What a DVM promises to callers, and what the handler and SDK each own.
- [Payments and payouts](/docs/builder-payments.md): Distinguish customer payments, earned revenue, refunds, and funds paid out to the builder.
- [Deploying](/docs/deploying.md): Hosting responsibilities, persistence, and costs when a local capability becomes a service.
- [Builder access](/docs/builder-access.md): Accounts, organization scope, signing identity, and payment recovery keys.
- [Operating a DVM](/docs/builder-operations.md): Interpret service health, earnings, payouts, and unresolved customer obligations.

- **Use**
- [Quickstart](/docs/quickstart.md): Install the CLI and the dvm agent skill, fund a wallet, and make your first paid call.
- [Agent setup](/docs/agent-setup.md): Install the dvm skill and configure network egress for sandboxed coding-agent harnesses, covering Claude Code, Cursor, and Codex.
- [Funding](/docs/funding.md): Put money in your agent's wallet from wherever you start, whether that is an exchange account, a Lightning wallet, dollars on another chain, or nothing yet.
- [How it works](/docs/how-it-works.md): What actually happens when your agent calls a DVM, from finding one to collecting the result.
- [Payments](/docs/payments.md): How a single job gets quoted, paid, and settled, and what happens to your money when one fails.
- [Wallets](/docs/wallets.md): Where your agent's money lives, the four ways to put money in, and how to get it back out.
- [Budgets](/docs/budgets.md): Every limit on what your agent can spend without asking you, and which of them it cannot raise.
- [Credits](/docs/credits.md): Prepaid balances at a single provider, why your agent opens them, and what happens to the money when a job fails.
- [Receipts](/docs/receipts.md): The signed proof each job leaves behind, how it is checked, and what it is good for.
- [Security](/docs/security.md): The keys your agent holds, what sits on disk, and the secrets that must never leave your machine.
- [Privacy](/docs/privacy.md): What a provider learns about you, what the platform stores, and where the honest limits are.

- **Reference**
- [Logging in to dvmkit](/docs/cli-auth.md): How dvmctl authenticates, where its token lives, and how headless environments use an API key.
- [dvmctl CLI reference](/docs/cli-dvmctl.md): Complete reference for the dvmctl builder CLI — every command, flag, JSON output shape, and error anchor.
- [dvm CLI reference](/docs/dvm-cli.md): Complete reference for the dvm caller CLI, every command, flag, JSON output shape, and error anchor.
- DVM Reference: Reference documentation for dvmkit's first-party Digital Vending Machines.
  - [cast](/docs/dvms/cast.md): Reference for the cast DVM, which hosts private RSS feeds and podcast episodes, with six capabilities, retention pricing, and error codes.
  - [discover](/docs/dvms/discover.md): Reference for the discover DVM, which finds DVMs by keyword or natural language, or browses the full catalog, with pricing and error codes.
  - [narrate](/docs/dvms/narrate.md): Reference for the narrate DVM, which does text-to-speech with per-character pricing, quality tiers, voice personas, dialogue, and captions.
  - [scrape](/docs/dvms/scrape.md): Reference for the scrape DVM, doing a single-URL fetch to markdown / HTML / screenshot / metadata, with pricing, schema, and error codes.
  - [scribe](/docs/dvms/scribe.md): Reference for the scribe DVM, which converts audio / video to timestamped transcript, with tiered per-minute pricing, diarisation, schema, and error codes.
- [Protocol Specification](/docs/protocol.md): The DVM protocol is a turn-based conversation between a caller and a provider over HTTPS.
- [Resource configuration](/docs/resources.md): Choose memory, CPU, and scaling for a deployed DVM.
- [SDK Reference](/docs/sdk.md): Build DVMs with @dvmkit/sdk. Declare capabilities, inputs, pricing, and handlers. The SDK handles transport, payment, streaming, and persistence.