KDCO Workspace Setup

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:

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

Pre-configured models:

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

Clone for variations:

ocx profile add work --clone ws --global

For untrusted repos, see Profile Security.

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

Workspace Integration — Architecture details and component documentation.
Background Agents — Async delegation system.
Profiles Overview — Understanding profile concepts.

Getting Started

Profiles

CLI

Registries

Reference

Guides

Integrations

Enterprise

Security

Overview

Step 1: Install the ws Profile

Step 2: Launch

What’s Included

Customize Models

Tips

Troubleshooting

Next Steps

See Also

​Overview

​Step 1: Install the ws Profile

​Step 2: Launch

​What’s Included

​Customize Models

​Tips

​Troubleshooting

​Next Steps

​See Also

Overview

Step 1: Install the ws Profile

Step 2: Launch

What’s Included

Customize Models

Tips

Troubleshooting

Next Steps

See Also