Manage OpenCode configuration bundles and schema-validated multi-agent workflows
Source tape: docs/demo.tape
Repeatable capture steps: docs/demo-playbook.md
A CLI tool (occo) that manages OpenCode configuration bundles from external sources, enabling versioned, validated configs for AI agents.
# Install via Go (macOS/Linux)
go install github.com/qbicsoftware/occo@latest
# Register a config bundle
occo source add qbicsoftware/opencode-config-bundle --name qbic
# Install a preset
occo bundle install qbic --preset mixed --project-root .Detailed installation guide: docs/installation.md
Install methods:
go install(recommended)- Manual download from GitHub Releases
Enable tab completion for your shell:
# Bash: source on the fly, or install permanentlysource<(occo completion bash)
occo completion bash | sudo tee /etc/bash_completion.d/occo > /dev/null
# Zsh: source on the fly (recommended)source<(occo completion zsh)# Or save to completions dir:# occo completion zsh > ~/.zsh/completions/_occo# Add to ~/.zshrc: fpath=(~/.zsh/completions $fpath); ensure fpath is set before `compinit`# (Optional) Clear cache: rm -f ~/.zcompdump && exec zsh# Fish
occo completion fish >~/.config/fish/completions/occo.fishRun occo completion --help for full instructions.
| Concept | Description |
|---|---|
| Sources | Registered bundle repositories (GitHub releases) |
| Bundles | Versioned, schema-validated OpenCode configs |
| Presets | Named configurations (e.g., mixed, openai) |
- qbicsoftware/opencode-config-bundle — Official bundle with multiple presets
| Guide | Description |
|---|---|
| docs/README.md | User documentation hub |
| docs/installation.md | Install on macOS/Linux |
| docs/config-bundles.md | Understand bundles + create your own |
| docs/demo-playbook.md | Repeatable terminal demo script for README recordings |
| docs/cli-reference.md | Full command reference |
| docs/troubleshooting.md | FAQ and common issues |
The original Bash-based helper is deprecated. Use the Go CLI (occo) instead.
Archive documentation: docs/legacy/bash-helper.md
AGPL-3.0 — see the LICENSE file for details.