Pp Breezedoc

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/productivity/breezedoc/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Breezedoc — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the breezedoc-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install breezedoc --cli-only

2. Verify: breezedoc-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

go install github.com/mvanhorn/printing-press-library/library/productivity/breezedoc/cmd/breezedoc-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

Command Reference

documents — Manage documents

• breezedoc-pp-cli documents get — Get a specific document
• breezedoc-pp-cli documents list — Get list of documents
• breezedoc-pp-cli documents store — Create a new document

invoices — Manage invoices

• breezedoc-pp-cli invoices create — Creates a new invoice with line items. Optionally sends the invoice immediately by setting send: true.
• breezedoc-pp-cli invoices delete — Deletes a draft invoice. Cannot delete invoices that have already been sent.
• breezedoc-pp-cli invoices get — Get a specific invoice
• breezedoc-pp-cli invoices list — Retrieves a paginated list of invoices for the authenticated user.
• breezedoc-pp-cli invoices patch — Same as PUT - updates an existing invoice. Cannot update invoices with status paid, uncollectible, or void.
• breezedoc-pp-cli invoices update — Updates an existing invoice. Cannot update invoices with status: paid, uncollectible, or void.

me — Manage me

• breezedoc-pp-cli me — Get current user information

recipients — Manage recipients

• breezedoc-pp-cli recipients — Get list of recipients

teams — Manage teams

templates — Manage templates

• breezedoc-pp-cli templates get — Get a specific template
• breezedoc-pp-cli templates list — Get list of templates

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

breezedoc-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Auth Setup

Run breezedoc-pp-cli auth setup for the URL and steps to obtain a token (add --launch to open the URL). Then store it:

breezedoc-pp-cli auth set-token YOUR_TOKEN_HERE

Or set BREEZEDOC_API_TOKEN as an environment variable.

Run breezedoc-pp-cli doctor to verify setup.

Agent Mode

Add --agent to any command. Expands to: --json --compact --no-input --no-color --yes.

• Pipeable — JSON on stdout, errors on stderr

• Filterable — --select keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:

  breezedoc-pp-cli documents list --agent --select id,name,status

• Previewable — --dry-run shows the request without sending

• Offline-friendly — sync/search commands can use the local SQLite store when available

• Non-interactive — never prompts, every input is a flag

• Explicit retries — use --idempotent only when an already-existing create should count as success, and --ignore-missing only when a missing delete target should count as success

Response envelope

Commands that read from the local store or the API wrap output in a provenance envelope:

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

Parse .results for data and .meta.source to know whether it's live or local. A human-readable N results (live) summary is printed to stderr only when stdout is a terminal AND no machine-format flag (--json, --csv, --compact, --quiet, --plain, --select) is set — piped/agent consumers and explicit-format runs get pure JSON on stdout.