ocx init

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

Usage

ocx init [options]
ocx init --registry <path> [options]

Initialize OCX configuration in your project directory or globally. When used with --registry, scaffolds a new OCX registry project.

Flag	Shorthand	Default	Description
`--cwd <path>`		Current directory	Working directory
`--quiet`	`-q`	`false`	Suppress output
`--verbose`	`-v`	`false`	Verbose output
`--json`		`false`	Output as JSON
`--registry <path>`			Scaffold a new OCX registry project at path
`--namespace <name>`			Registry namespace (e.g., my-org)
`--author <name>`			Author name for the registry
`--canary`		`false`	Use canary (main branch) instead of latest release
`--local <path>`			Use local template directory instead of fetching
`--global`	`-g`	`false`	Initialize in global OpenCode config (`~/.config/opencode`)

ocx init

Creates .opencode/ocx.jsonc in the current directory with a default registry configuration.

ocx init --global

Creates the global profile directory at ~/.config/opencode/ with base configuration. This is required before creating profiles.

ocx init --registry ./my-registry --namespace my-org --author "My Name"

Creates a new registry project with the proper directory structure, manifest, and example components.