Marketplace

rensei marketplace lets you discover agent configurations published to the Rensei Agent Registry. Browse by work type or provider, then use the returned card ID with rensei agent run-card to dispatch a session using that agent definition.

Command

`marketplace browse`

Browse available agents in the Agent Registry.

rensei marketplace browse \
  [--work-type <type>] \
  [--provider <id>] \
  [--json]

Flag	Description
`--work-type <type>`	Filter by work type (e.g. `development`, `research`, `qa`, `code-review`, `planning`)
`--provider <id>`	Filter by Agent Registry Provider (ARP) ID (e.g. `local`, `arp-github-marketplace`)
`--json`	Emit results as a JSON array

# Browse all available agents
rensei marketplace browse

# Find agents for code review work
rensei marketplace browse --work-type code-review

# Browse agents published by a specific provider
rensei marketplace browse --provider arp-github-marketplace

# Machine-readable output
rensei marketplace browse --work-type development --json

Example output:

CARD ID                              NAME                   WORK TYPE     PROVIDER              VERSION
card_abc123                          TypeScript Backend      development   local                 1.0.0
card_def456                          Security Reviewer       code-review   arp-github-mktpl      2.1.0
card_ghi789                          QA Automation Agent     qa            local                 0.9.1
card_jkl012                          Research Synthesizer    research      arp-acme-internal     1.2.3

Example JSON output:

[
  {
    "id": "card_abc123",
    "name": "TypeScript Backend",
    "description": "Full-stack TypeScript development agent with Node.js toolchain",
    "workType": "development",
    "providerId": "local",
    "version": "1.0.0",
    "capabilities": ["typescript", "nodejs", "postgres", "testing"],
    "authModes": ["host-session", "local", "metered"],
    "updatedAt": "2026-05-20T10:00:00Z"
  }
]

Dispatching an agent from the marketplace

Once you have a card ID, dispatch a session using it with rensei agent run-card:

rensei agent run-card <card-id> [--project <slug>]

rensei agent run-card card_abc123
rensei agent run-card card_def456 --project my-fintech-app

This is equivalent to creating a session with the AgentCard's full definition - system prompt, tool allowlist, model profile, capability constraints, and Handlebars partial stack - applied automatically. See Agent cards CLI for details.

Agent Registry Providers (ARP)

The marketplace is backed by one or more Agent Registry Providers. Each ARP is an implementation of the IAgentRegistryProvider interface and can serve a different catalog:

Provider ID	Source	Description
`local`	Your org	Agent cards authored and published within your org
`arp-github-marketplace`	GitHub Marketplace	Community-contributed agent cards via the GitHub Marketplace integration

Your org may also have private ARP instances connected. Run rensei capacity provider list --family agentregistry to see all registered ARP providers.

For the full ARP interface specification and how to implement a custom provider, see Agent Registry Providers.

Agent cards CLI - rensei agent cards and run-card commands
Agent cards overview - 4-scope model, YAML authoring, extends, versioning
Agent Registry Providers (ARP) - provider interface, capability flags, custom registries
Capacity providers - capacity provider list to inspect registered ARPs

Command

marketplace browse

Dispatching an agent from the marketplace

Agent Registry Providers (ARP)

Related pages

On this page

`marketplace browse`