Marketplace

Marketplace

An Extensions marketplace for discovering and installing skills, commands, and subagents.

Refact’s marketplace is the discovery and installation layer for extension items. The marketplace currently classifies items into three kinds:

• Skill
• Command
• Subagent

Marketplace sources

The marketplace uses a source index stored in the engine’s bundled YAML/JSON assets and in a local sources database. The source model distinguishes between:

• built-in embedded sources
• built-in GitHub sources
• user GitHub sources

The marketplace source index is loaded from the bundled extensions_marketplace_sources.json asset, and user/source state is persisted in a project/user config file named extensions_marketplace_sources.json under the config directory.

Discovery and install flow

The extensions marketplace can:

1. load the registry of available sources
2. scan or parse repositories for supported extension kinds
3. list items with publisher, tags, path, and preview data
4. install an item into a selected scope
5. configure or disable sources
6. delete user-added sources

The install request includes:

• source_id
• item_id
• scope
• optional overwrite
• optional parameters for templated items

GUI surface

The GUI Extensions page exposes the marketplace through the extension tabs:

• Skills tab
• Commands tab
• Hooks tab

From the Skills and Commands tabs, the UI offers explicit buttons to browse the corresponding marketplace. That page is the main user-facing entry point for extension discovery and editing.

Implementation grounding

• engine/src/ext/extensions_marketplace.rs defines the item model, kinds, source records, scan/install logic, and source persistence
• gui/src/features/Extensions/Extensions.tsx renders the tabs and marketplace entry points
• gui/src/services/refact/extensions.ts exposes the registry and CRUD APIs for the GUI

flowchart TD
  A[Marketplace index source] --> B[Source list]
  B --> C[Scan repository]
  B --> D[Parse manifest]
  C --> E[Skills]
  C --> F[Commands]
  C --> G[Subagents]
  H[GUI Extensions page] --> I[Skills tab]
  H --> J[Commands tab]
  H --> K[Hooks tab]
  I --> L[Browse Skills Marketplace]
  J --> M[Browse Commands Marketplace]

Loading

See also: Skills Commands Hooks, Subagents