Skip to main content

​
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

ocx oc -p ws
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:
CategoryComponents
Pluginsworkspace-plugin, background-agents, notify, worktree
Agentsresearcher, coder, scribe, reviewer
Skillsplan-protocol, code-review, code-philosophy, frontend-philosophy
Commands/review
MCPContext7, Exa, GitHub Grep
Pre-configured models:
AgentModel
plan, build, coderBig Pickle
explore, researcher, scribe, reviewerGPT-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
Clone for variations: 
ocx profile add work --clone ws --global
For untrusted repos, see Profile Security.

​
Troubleshooting

ProblemSolution
Terminal hangs on first runClose the terminal and rerun ocx oc -p ws. This can happen during initial dependency installation.

​
Next Steps

​
See Also