Skip to main content

Usage

ocx search [query] [options]
ocx list [options]  # alias

Description

Search for components across configured registries or list installed components. The ocx list alias provides a convenient shorthand.

Arguments

ArgumentRequiredDescription
queryNoSearch query string

Flags

FlagShorthandDefaultDescription
--installedfalseList installed components only
--profile <name>-pUse specific profile
--limit <n>20Limit number of results
--cwd <path>Current directoryWorking directory
--quiet-qfalseSuppress output
--verbose-vfalseVerbose output
--jsonfalseOutput as JSON

Examples

Search for Components

ocx search button

List All Available Components

ocx list

List Installed Components Only

ocx search --installed

Limit Results

ocx search button --limit 5

Output

$ ocx search agent
Found 3 components:
  kdco/researcher (agent) - AI agent definitions
  kdco/background-agents (plugin) - Background agent sync plugin
  acme/agent-utils (lib) - Agent utility functions

$ ocx search --installed
Installed components (2):
  kdco/researcher v1.2.0 from kdco
  kdco/notify v0.5.0 from kdco

Errors

ErrorCauseSolution
No ocx.jsonc foundNot initializedRun ocx init first
No components installedReceipt data empty or missingRun ocx add first

See Also