Catalog

catalog.caplets.dev

is the public search surface for Caplets. It lists official Caplets from this repository and public community Caplets discovered from successful public 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 performs basic public-source eligibility checks, bounded ingestion, sanitized Markdown rendering, count bucketing, and operator suppression. It does not claim semantic malware review, dependency scanning, vulnerability scanning, secret scanning, or human approval.

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>

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.