Skip to main content

Marketplace Publishing

Anything you build for Codebolt can be published to the marketplace — agents, plugins, skills, MCPs, and more. Once published, your item is discoverable and installable from the desktop app, CLI, and TUI.

Publishing happens from the cloud portal or the CLI. Every entity type follows the same pattern:

# Create a new entity from a template
codebolt action <entity> create --name my-item --path ./my-item

# Publish to the registry
codebolt action <entity> publish --path ./my-item

# List what you've published
codebolt action <entity> list

What you can publish​

Listing metadata​

For every entity type the listing form collects:

  • Name and slug — globally unique
  • Description — Markdown supported
  • Tags / categories — drives discovery and filtering
  • Cover image / screenshots — hosted on the portal CDN
  • Version — semver; new versions supersede old but older versions remain installable
  • Visibility — public (full marketplace) or unlisted (installable by URL; good for team-private items)
  • Pricing — free or paid (paid routes through the portal billing system)

Managing published items​

The My view of each entity type lets you:

  • Edit metadata (description, tags, cover image)
  • Upload a new version
  • Deprecate — keeps old installs working; hides from new discovery
  • Delete — breaks existing installs; use deprecate instead unless the item was never used
  • View ratings, downloads, and usage stats per version

Who can publish​

Anyone with a signed-in account can publish. Team-owned items on self-hosted deployments can be restricted to team admins — see Teams → Roles.