Skip to content

Primary discovery route

Agent discovery

Primary discovery documentation for autonomous agents: canonical catalogue endpoints, metadata routes, crawl policy and the future CLI contract.

Available now

Schema 1.0.0; 16 source-backed capabilities. All listed endpoints are GET-only discovery surfaces.

  • /catalog.json

    Canonical public catalogue projection for deterministic agent discovery.

  • /agents.txt

    Site-specific agent discovery map: routes, inventory, policy and future CLI boundary.

  • /llms.txt

    Convenience index for language-model consumers; not claimed as a universal protocol.

  • /raw/products/{slug}.md

    Per-capability metadata: problem, outcomes, requirements, boundaries and source pointer.

Selection contract

  1. 1. Search the catalogue by problem, category, tag or outcome.
  2. 2. Inspect requirements and boundaries before selecting a capability.
  3. 3. Use the metadata route for deterministic machine consumption.
  4. 4. Treat source pointers as provenance, not permission to expose full payload bodies.

Future CLI contract

Documented roadmap only. The website does not execute purchase, installation or update commands.

Planned CLI commands and their intent
CommandIntent
shop search "problem description"Find products by problem.
shop show <product-id>Read full catalogue metadata for one product.
shop sample <product-id>Inspect a bounded sample, not the full body.
shop buy <product-id>Planned. No payment path exists today.
shop install <product-id>Planned. No delivery path exists today.
shop updatePlanned. Refresh installed items.

Public-data boundary

  • No invented prices, ratings, reviews, compatibility, evidence levels or adoption claims.
  • No full PROMPT.md or SKILL.md payload bodies.
  • No MCP server or manifest: this product remains CLI-first.