marketplace:search

Searches features in the marketplace index, or lists a forge organisation live. With an index the search works offline and understands the feature contracts, so you can filter by what a feature provides or requires.

---

Example

splent marketplace:search
splent marketplace:search auth
splent marketplace:search --archetype service
splent marketplace:search --provides MediaService
splent marketplace:search --requires auth
splent marketplace:search --org my-org        # live listing of a forge org

  Marketplace search — requires=auth
  ────────────────────────────────────────────────────────────────────────
  ● admin   1.1.0     full     Auto-generated CRUD admin panel for all product models
    notes   0.0.1     full     Notes with title and body owned by the user

  2 feature(s) · index from cache · details: splent feature:info <name>

● marks features installed in the active product. index from reads cache or url.

Options

Argument / Option	Description
QUERY	Substring match over name, repository, description, tags and provided services and models.
--category	Filter by contract category.
--archetype	Filter by archetype (full, light, service, config).
--tag	Filter by contract tag.
--provides	Filter by a provided route, service, model, hook or signal (exact name).
--requires	Filter by a required feature’s short name, such as auth.
--refresh	Fetch the index from SPLENT_INDEX_URL and replace the local copy.
--org	Live mode. List this forge organisation instead of reading the index.
--all	Live mode. Show every repository, not only those with feature in the name.

Filters combine with AND.

---

What it does

1. Finds an index. The local copy in .splent_cache/marketplace/index.json, built by marketplace:index or saved by an earlier fetch, wins whenever it exists. SPLENT_INDEX_URL is fetched only when there is no copy or with --refresh. See Marketplace.
2. Searches it with the query and the filters.
3. Falls back to live mode with --org or --all, or when no index exists anywhere. It lists the organisation’s repositories on the configured forge (git.splent.io unless SPLENT_FORGE_HOST says otherwise, splent-io without --org), each with its latest semver tag and description. QUERY matches the repository name only, the other filters are ignored, and without an index it suggests building one.

Set SPLENT_FORGE_TOKEN, or GITHUB_TOKEN, to raise the forge API rate limit and see private repositories.

Special cases

• feature:search. The same command under another name, see feature:search. In a product that installs a feature called search, feature:search is that feature’s namespace and this command answers only to marketplace:search.

See also

• feature:info shows the full contract of one result.