ocx search

Legacy reference: this page describes OCX 2 for OpenCode V1. For OCX 3 and OpenCode V2, see the V2 documentation.

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

Argument	Required	Description
`query`	No	Search query string

Flags

Flag	Shorthand	Default	Description
`--installed`		`false`	List installed components only
`--profile <name>`	`-p`		Use specific profile
`--limit <n>`		`20`	Limit number of results
`--cwd <path>`		Current directory	Working directory
`--quiet`	`-q`	`false`	Suppress output
`--verbose`	`-v`	`false`	Verbose output
`--json`		`false`	Output 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

Error	Cause	Solution
`No ocx.jsonc found`	Not initialized	Run `ocx init` first
`No components installed`	Receipt data empty or missing	Run `ocx add` first

Getting Started

Profiles

CLI

Registries

Reference

Guides

Integrations

Enterprise

Security

Usage

Description

Arguments

Flags

Examples

Search for Components

List All Available Components

List Installed Components Only

Limit Results

Output

Errors

See Also

​Usage

​Description

​Arguments

​Flags

​Examples

​Search for Components

​List All Available Components

​List Installed Components Only

​Limit Results

​Output

​Errors

​See Also

Usage

Description

Arguments

Flags

Examples

Search for Components

List All Available Components

List Installed Components Only

Limit Results

Output

Errors

See Also