Pp Jobber

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/sales-and-crm/jobber/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/". -->

Jobber — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the jobber-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 jobber --cli-only

2. Verify: jobber-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/sales-and-crm/jobber/cmd/jobber-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.

When to Use This CLI

Use jobber-pp-cli when an agent or user needs offline analysis of a Jobber tenant: AR aging, invoice payment tracing, week-over-week snapshot diffs, full-text search across synced data, or ad-hoc SQL over the local store. It is read-only by design — pair it with QBO or another accounting CLI for full reconciliation. It does not write to Jobber.

When Not to Use This CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Accounting & AR analysis

• ar aging — Aged AR by client with 0-30/31-60/61-90/90+ buckets and per-bucket totals — answers the question every advisor and bookkeeper asks first, offline and instantly.

  Reach for this whenever the user asks about overdue invoices, collections risk, or DSO. It's the offline-first, agent-shaped equivalent of opening the Jobber AR report and re-pivoting in Excel.

  jobber-pp-cli ar aging --as-of 2026-05-15 --json --select client,bucket_0_30,bucket_31_60,bucket_61_90,bucket_over_90

• invoices trace — Per-invoice ledger: total billed, sum of payment records, balance, allocated payout reference, status drift. --mismatched filters to invoices where payments don't equal total.

  Use when the user asks 'why is this invoice still open' or wants to find misposted payments. One row per invoice covers everything the Jobber UI buries three clicks deep.

  jobber-pp-cli invoices trace --mismatched --json

Diligence & diff

• snapshot diff — Diff two labeled SQLite snapshots: new clients, status transitions, paid invoices, open-AR deltas per client. --save <label> tags the current DB for a later diff.

  Reach for this on a weekly cadence to write client memos, identify deltas, or build an audit log of changes between two points in time.

  jobber-pp-cli snapshot diff 2026-05-15 2026-05-22 --json

Command Reference

clients — Clients (Jobber clients Relay connection)

• jobber-pp-cli clients get — Get a client by EncodedId
• jobber-pp-cli clients list — List clients with optional filters

invoices — Invoices (Jobber invoices Relay connection)

• jobber-pp-cli invoices — List invoices with optional filters

jobber_jobs — Jobs (Jobber jobs Relay connection). Resource key is jobber_jobs to avoid press v4.9.0 reserved-cobra collision; post-rewrite renames Cobra Use back to jobs and removes the unused built-in jobs ledger.

• jobber-pp-cli jobber_jobs get — Get a job by EncodedId
• jobber-pp-cli jobber_jobs list — List jobs with optional filters

payment-records — Payment records (Jobber paymentRecords Relay connection, PaymentRecordInterface)

• jobber-pp-cli payment-records — List payment records with optional filters (entryDate is exclusive both ends - pad +/-1 day)

properties — Properties (Jobber properties Relay connection)

• jobber-pp-cli properties — List properties with optional filters

quotes — Quotes (Jobber quotes Relay connection)

• jobber-pp-cli quotes — List quotes with optional filters

visits — Visits (Jobber visits Relay connection)

• jobber-pp-cli visits — List visits with optional filters

Finding the right command

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

jobber-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.

Recipes

Build a weekly AR delta memo

jobber-pp-cli snapshot save 2026-05-22
jobber-pp-cli snapshot diff 2026-05-15 2026-05-22 --json

Saves a labeled DB snapshot, then diffs it against last week to surface new clients, status transitions, newly paid invoices, and per-client open-AR deltas — exactly the changes that belong in a weekly client memo.

Find invoices where payments don't match the total

jobber-pp-cli invoices trace --mismatched --json

Per-invoice ledger comparing total, payments_total, deposit_amount, and the sum of underlying payment records. Flags any drift > $0.005 — the misposted-payment finder.

Ad-hoc SQL against the local store

jobber-pp-cli sql "SELECT invoice_number, total, payments_total FROM invoices WHERE invoice_status='awaiting_payment' ORDER BY total DESC LIMIT 25" --json

Read-only ad-hoc SQL (write tokens rejected at the CLI layer + sqlite mode=ro) for anything the curated commands don't already answer.

Full-text search across synced data

jobber-pp-cli search "kitchen renovation" --json --limit 20

FTS5 search across every synced resource — clients, jobs, invoices, properties, quotes, visits, payment records — without hitting the live API.