Usage
Description
Manage configured component registries. Registries are sources for components that OCX can install. By default, registry commands operate on local project configuration; use --global for global scope.
Subcommands
Registry Add
Add a new registry to your configuration.
Usage
Arguments
Flags
Examples
Identity Model
- Registry name is canonical identity: The
--name you provide becomes the canonical identifier for the registry in your configuration.
- Components referenced as
name/component: Users reference components using the configured registry name (e.g., kdco/researcher).
- Registry
index.namespace not authoritative: The namespace field in the registry’s index.json is informational only.
Constraints
- URL uniqueness: The same URL cannot be added under multiple names. To change the name, remove it first with
ocx registry remove <name>, then add with the new name.
- No
--force for conflicts: Use remove-then-add to update an existing registry name or URL.
Errors
--global and --cwd are mutually exclusive.
Registry Remove
Remove a registry from your configuration.
Usage
Arguments
Flags
Examples
Errors
Registry List
List all configured registries.
Usage
Flags
Examples
Output
See Also