Workspace Bundle

Legacy reference: this page describes OCX 2 for OpenCode V1. For OCX 3 and OpenCode V2, see the V2 documentation.

Overview

A curated collection of 16 components that work together as a complete AI development harness. Installing kdco/workspace gives you specialist agents, planning tools, code review workflows, notifications, and worktree isolation.

Quick Start

# Install via profile for complete, isolated configuration
ocx profile add ws --source kit/ws --from https://ocx-kit.kdco.dev --global
ocx oc -p ws

Or install directly into a project:

ocx add kdco/workspace --from https://registry.kdco.dev

See the KDCO Workspace Guide for full installation and customization.

Architecture

┌──────────────────────────────────────────────────────────────────┐
│                          ORCHESTRATORS                           │
│            ┌──────┐                    ┌───────┐                 │
│            │ plan │                    │ build │                 │
│            └──┬───┘                    └───┬───┘                 │
└───────────────┼────────────────────────────┼─────────────────────┘
                │                            │
        ┌───────┴───────┐            ┌───────┴───────┐
        ▼       ▼       ▼            ▼       ▼       ▼
┌──────────────────────────────────────────────────────────────────┐
│                           SPECIALISTS                            │
│  ┌─────────┐ ┌────────────┐ ┌───────┐ ┌────────┐ ┌──────────┐    │
│  │ explore │ │ researcher │ │ coder │ │ scribe │ │ reviewer │    │
│  └─────────┘ └────────────┘ └───────┘ └────────┘ └──────────┘    │
└──────────────────────────────────────────────────────────────────┘

Role	Agents
Orchestrators	`plan`, `build`
Specialists	`explore`, `researcher`, `coder`, `scribe`, `reviewer`

Components

Category	Component	Description
Plugin	workspace-plugin	Plan management, agent rule injection
Plugin	background-agents	Capability-based background lifecycle (`delegate` for read-only sub-agents, `task` for write-capable) with durable markdown outputs
Plugin	notify	OS notifications on completion
Plugin	worktree	Git worktree isolation
Plugin	@tarquinen/opencode-dcp	Differential context protocol
Plugin	@franlol/opencode-md-table-formatter	Markdown table formatting
Skill	plan-protocol	Implementation planning guidelines
Skill	code-review	Review methodology + severity classification
Skill	code-philosophy	Internal logic philosophy (5 Laws)
Skill	frontend-philosophy	Visual/UI philosophy (5 Pillars)
Agent	researcher	External research (MCP tools, read-only)
Agent	coder	Implementation (full file + bash)
Agent	scribe	Documentation (write, no bash)
Agent	reviewer	Code review (read-only + git)
Command	review	`/review` slash command
MCP	context7, exa, gh_grep	Library docs, web search, GitHub code search

Permissions

The bundle configures security boundaries:

Scope	Setting
Global	`webfetch: deny` — no direct web fetching
plan	Read-only orchestrator, delegates via `task` tool
build	Read-only orchestrator, delegates via `task` tool
explore	Read-only specialist, filesystem + git inspection only
researcher	Read-only, MCP tools only (Context7, Exa, GitHub Grep)
coder	Full file + bash access
scribe	File write only, no bash
reviewer	Read-only + git inspection

Getting Started

Profiles

CLI

Registries

Reference

Guides

Integrations

Enterprise

Security

Overview

Quick Start

Architecture

Components

Permissions

See Also

​Overview

​Quick Start

​Architecture

​Components

​Permissions

​See Also

Overview

Quick Start

Architecture

Components

Permissions

See Also