Picklelist is a local-first habit and workout PWA. Most user data stays in the browser; signed-in users can opt into HTTP sync backed by Postgres.

OpenAPI

Machine-readable HTTP surface at /openapi.json. Prefer these JSON routes over scraping HTML when building agents.

Public catalog (free, no API key)

Read-only Andrew Heim + K Boges packs — same data as /@. Stable human URLs stay /@{creator}/{slug}; agents should call:

• GET /api/v1/catalog/creators — listCatalogCreators
• GET /api/v1/catalog/creators/{creatorSlug} — getCatalogCreator
• GET /api/v1/catalog/creators/{creatorSlug}/routines — listCatalogRoutines
• GET /api/v1/catalog/creators/{creatorSlug}/routines/{routineSlug} — getCatalogRoutine (title, steps/checklist, source URL, disclaimer, creator)

Rate limit: 120 requests/minute per client IP (see X-RateLimit-Limit and Retry-After on 429). Responses are cached with Cache-Control: public, max-age=3600.

Personal Today API (signed in)

Bearer key from Settings — scopes todos:read / todos:write for /api/v1/today/items.

Agent discovery (ARD)

Publisher manifest for agents and registries:

/.well-known/ard.json

MCP

A streamable MCP server for habit check-ins and sync is planned. A placeholder server card is published at /.well-known/mcp/server-card.json until tools ship.