feature:search

Search features in the marketplace index, or live on GitHub.

Usage

splent feature:search [QUERY] [--category C] [--archetype A] [--tag T] [--provides X] [--requires F] [--refresh] [--org ORG] [--all]

Argument / Option	Description
`QUERY`	Substring match over name, description, tags and provided services/models.
`--category`	Filter by contract `category` (e.g. `content`, `integration`).
`--archetype`	Filter by archetype (`full`, `light`, `service`, `config`).
`--tag`	Filter by contract tag.
`--provides`	Filter by a provided route/service/model/hook/signal (exact name).
`--requires`	Filter by required feature short name (e.g. `auth`).
`--refresh`	Re-fetch the index from `SPLENT_INDEX_URL`.
`--org`	Live mode. List this GitHub organisation instead of the index.
`--all`	Live mode. Show all repos, not just `splent_feature_*` ones.

Examples

splent feature:search
splent feature:search auth
splent feature:search --archetype service
splent feature:search --provides MediaService
splent feature:search --requires auth
splent feature:search --org my-company        # live GitHub listing

Example output

  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
    signup  0.0.1     light    Public self-registration for closed products

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

● marks features already installed in the active product.

Description

With a marketplace index available (built locally with marketplace:index, or fetched from SPLENT_INDEX_URL), the search is instant, works offline, and understands the feature contracts, so you can ask questions like “which features provide a MediaService?” or “what depends on auth?”.

Passing --org/--all, or having no index at all, falls back to the historical live listing. It paginates the GitHub organisation’s repos and shows each repo’s latest tag and description.

Notes

Build the local index once with splent marketplace:index --local (offline, instant) or splent marketplace:index (from GitHub).
Set GITHUB_TOKEN to raise the GitHub API rate limit in live mode.
For the full contract card of a result, use feature:info <name>; to install it, feature:install <org>/<repo>.