Public explanation kit

Use the shortest public-facing package when you explain the project.

This page keeps the reusable punchline, the lightweight 10-second demo, the compare card, and the release snippet structure in one place so public explanations stay aligned.

Punchline

Use upstream for the engine. Use this repo for the local control room.

That is the shortest accurate way to explain why Apple Notes Snapshot exists as a wrapper instead of pretending to replace the upstream exporter.

  • AI Diagnose: operator next-step explanation layer
  • Local Web API: token-gated same-machine browser/API lane
  • MCP Provider: read-only agent-facing substrate

10-second demo

Use the run-flow asset when you want to show the shortest believable path: review the path, trigger the first export, then install the scheduler and verify health.

Three-step run flow showing the Apple Notes Snapshot first-successful-run path

Compare card

Use the compare card when you need to show where the wrapper adds value without turning the pitch into a long architecture speech.

Comparison card showing where Apple Notes Snapshot adds scheduling, health checks, logs, and a control room around the upstream exporter

If the audience is builder-heavy, also link the Local Web API, For Agents, and MCP Provider pages.

Release snippet structure

  • Why this matters: who should care and why the release is worth opening now
  • What changed for first-time visitors: storefront, quickstart, docs, or support shifts
  • Upgrade or migration: what changed operationally and how to roll back
  • Known limitations: what is still manual, local-only, or intentionally out of scope
  • Links: changelog, docs release page, support, and quickstart

What is already repo-ready

  • Short demo: docs/assets/run-flow.gif for the believable first-successful-run path
  • Compare card: docs/assets/upstream-vs-snapshot.png for the upstream-vs-wrapper story
  • Social preview: docs/assets/social-preview.png for cards and link previews
  • Release history: release page for tagged truth versus current main
  • Short copy: 30-second overview for the shortest accurate public framing

Copy-ready snippets

Reuse these when you need truthful public copy without inventing a bigger platform story.

Repository description

Local-first Apple Notes backup control room for macOS with AI diagnostics, a token-gated local Web API, a read-only MCP surface, and builder-friendly entry points for Codex and Claude Code-style local workflows.

Release or announcement blurb

Apple Notes Snapshot keeps the upstream exporter, then adds scheduling, health checks, a token-gated Local Web API, AI Diagnose, and a read-only MCP surface so the same local backup facts stay visible to humans and coding agents.

Short social teaser

Use upstream for the engine. Use this repo for the local control room. Apple Notes Snapshot adds scheduling, health checks, and truthful local builder surfaces without pretending to be a hosted notes platform.