Documentation Index
Fetch the complete documentation index at: https://ocx.kdco.dev/docs/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Set up the KDCO Workspace multi-agent harness with OCX profiles for a fully portable AI coding environment with planning, code review, delegation, and notifications.
Prerequisites: OCX installed and global profiles initialized
Step 1: Install the ws Profile
# One-command install with ephemeral registry (not saved)
ocx profile add ws --source kit/ws --from https://ocx-kit.kdco.dev --global
# Or add registries first, then install
ocx registry add https://ocx-kit.kdco.dev --name kit --global
ocx profile add ws --source kit/ws --global
Step 2: Launch
The profile comes pre-configured with free OpenCode Zen models and the full workspace bundle.
What’s Included
The ws profile installs the complete KDCO Workspace:
| Category | Components |
|---|
| Plugins | workspace-plugin, background-agents, notify, worktree |
| Agents | researcher, coder, scribe, reviewer |
| Skills | plan-protocol, code-review, code-philosophy, frontend-philosophy |
| Commands | /review |
| MCP | Context7, Exa, GitHub Grep |
| Agent | Model |
|---|
| plan, build, coder | Big Pickle |
| explore, researcher, scribe, reviewer | GPT-5 Nano |
Customize Models
Edit your profile’s OpenCode config:
# View available models
opencode models
# Edit the config
$EDITOR ~/.config/opencode/profiles/ws/opencode.jsonc
Tips
Set as default profile:
export OCX_PROFILE=ws # Add to ~/.zshrc or ~/.bashrc
ocx profile add work --clone ws --global
Troubleshooting
| Problem | Solution |
|---|
| Terminal hangs on first run | Close the terminal and rerun ocx oc -p ws. This can happen during initial dependency installation. |
Next Steps
See Also
