Quickstart

This is the shortest path from a fresh install to a working profile switch.

1. Add a repository

Git-backed repository:

ocp repository add git@github.com:my-company/opencode-profiles.git --name my-company

Local file-based repository:

ocp repository add /absolute/path/to/my-profiles --name my-local-profiles

For repository types and storage behavior, see Repositories and profiles and Configuration and paths.

2. Inspect repositories and profiles

ocp repository list
ocp profile list

repository list shows the configured repositories. profile list shows the available profiles.

For exact table columns, width behavior, and update notes, see Repository commands and Profile commands.

3. Activate a profile

ocp profile use my-company

When you switch, ocp links profile files into ~/.config/opencode/ and handles backups and rollback for you. See Backups and switching for the file-level rules.

4. Confirm the active profile

ocp profile

This prints the current profile together with repository/version metadata and any update hints. See Profile commands for the output details.