https://github.com/qbicsoftware/occo
Useful agents configuration for various daily tasks.
https://github.com/qbicsoftware/occo
Last synced: 3 months ago
JSON representation
Useful agents configuration for various daily tasks.
- Host: GitHub
- URL: https://github.com/qbicsoftware/occo
- Owner: qbicsoftware
- License: agpl-3.0
- Created: 2026-02-18T08:23:50.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-04-14T15:18:12.000Z (3 months ago)
- Last Synced: 2026-04-14T15:32:03.726Z (3 months ago)
- Language: Go
- Size: 7.5 MB
- Stars: 3
- Watchers: 0
- Forks: 2
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Occo
[](LICENSE)
[](https://github.com/qbicsoftware/occo/blob/main/go.mod)
[](https://github.com/qbicsoftware/occo/releases)
[](https://github.com/qbicsoftware/occo/actions/workflows/ci.yml)
[](https://github.com/qbicsoftware/occo/actions/workflows/e2e-cli.yml)
**Manage OpenCode configuration bundles and schema-validated multi-agent workflows**
## CLI Demo
Source tape: [docs/demo.tape](docs/demo.tape)
Repeatable capture steps: [docs/demo-playbook.md](docs/demo-playbook.md)
## What is this?
A CLI tool (`occo`) that manages OpenCode [configuration bundles](docs/config-bundles.md) from external sources, enabling versioned, validated configs for AI agents.
## Quick Start (30 seconds)
```sh
# 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 .
```
## Installation
Detailed installation guide: [docs/installation.md](docs/installation.md)
Install methods:
- `go install` (recommended)
- Manual download from GitHub Releases
## Shell Completion
Enable tab completion for your shell:
```sh
# Bash: source on the fly, or install permanently
source <(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)
# Clear cache: rm -f ~/.zcompdump && exec zsh
# Fish
occo completion fish > ~/.config/fish/completions/occo.fish
```
Run `occo completion --help` for full instructions.
## Key Concepts
| Concept | Description |
|---------|-------------|
| **Sources** | Registered bundle repositories (GitHub releases) |
| **Bundles** | Versioned, schema-validated OpenCode configs |
| **Presets** | Named configurations (e.g., `mixed`, `openai`) |
## Available Bundles
- [qbicsoftware/opencode-config-bundle](https://github.com/qbicsoftware/opencode-config-bundle) — Official bundle with multiple presets
## Documentation
| Guide | Description |
|-------|-------------|
| [docs/README.md](docs/README.md) | User documentation hub |
| [docs/installation.md](docs/installation.md) | Install on macOS/Linux |
| [docs/config-bundles.md](docs/config-bundles.md) | Understand bundles + create your own |
| [docs/demo-playbook.md](docs/demo-playbook.md) | Repeatable terminal demo script for README recordings |
| [docs/cli-reference.md](docs/cli-reference.md) | Full command reference |
| [docs/troubleshooting.md](docs/troubleshooting.md) | FAQ and common issues |
## Legacy (Bash Version)
The original Bash-based helper is deprecated. Use the Go CLI (`occo`) instead.
Archive documentation: [docs/legacy/bash-helper.md](docs/legacy/bash-helper.md)
---
## License
AGPL-3.0 — see the [LICENSE](LICENSE) file for details.