Catalog

catalog.caplets.dev

is the public search surface for Caplets. It lists official Caplets from this repository and community Caplets submitted after eligible GitHub-shaped external installs.

Browse public catalog ↗

Catalog entries show the Caplet name, description, tags, source repository, setup and auth readiness, warning labels, aggregate install counts, readable CAPLET.md content, and a generated install command when the catalog can tie that command to inspected content.

Safety model

The catalog is not a scanner, certification program, endorsement list, or moderation queue. V1 validates source syntax but does not verify GitHub repository visibility before submission. Catalog ingestion is bounded, renders Markdown through a sanitizer, buckets counts, and supports operator suppression. It does not claim semantic malware review, dependency scanning, vulnerability scanning, secret scanning, or human approval. Disable catalog indexing before installing private repositories or Caplet content that must not become public.

Install counts are popularity and ranking signals only. They are not safety, quality, or trust signals.

Install commands

Install commands are generated by Caplets from normalized source metadata and Caplet IDs. Community Markdown cannot author the copyable command shown by the catalog.

Result rows may show a command preview. Copy actions live on detail pages after the source content and warnings are visible. If content cannot be inspected or tied to a revision or content hash, the catalog hides copy actions and shows recovery guidance instead.

Public API

Agents and tools should use the structured read API rather than scraping HTML:

• https://catalog.caplets.dev/api/v1/catalog
• https://catalog.caplets.dev/api/v1/catalog/entries/<entryKey>

Use ?view=compact for the content-free index projection. Add limit=1..500, sort=asc|desc, optional after=<entryKey>, and optional q=<query> for a bounded keyset page. A response with more matches includes nextEntryKey; pass that exact opaque key as the next after value with the same sort and query.

The API returns the same shared catalog entry model used by the site and CLI indexing statuses. The npm subpath @caplets/core/catalog exposes worker-safe implementation helpers for this v1 model, but the stable external discovery contract is the versioned HTTP API.