Skip to content
This repository was archived by the owner on Sep 16, 2026. It is now read-only.

Latest commit

 

History

40 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

opencode-workspace

Retired — OpenCode V1 only. No OpenCode V2 port is planned. Use OCX 2.0.15 with OpenCode V1 for the legacy installation instructions below. Existing published packages, tags, and registry artifacts remain available.

Use OpenCode V2’s native agents, background subagents, planning, compaction, and skills. This bundle’s orchestration hooks, planning reminders, research conventions, and custom tool APIs are not being ported. These are workflow alternatives, not complete replacements for every custom feature. See the official V2 migration guide and V2 terminal settings.

Bundled multi-agent orchestration harness for OpenCode. One install, complete control.

Quick Start

# One-time setup
ocx init --global

# Install the KDCO workspace profile (OpenCode Free Models Only)
ocx profile add ws --source tweak/p-1vp4xoqv --from https://tweakoc.com/r --global

# Launch
ocx oc -p ws

Need a custom profile? Open the KDCO Workspace harness in TweakOC: https://tweakoc.com/h/kdco-workspace

See the full installation guide for more customization options.

What This Is

A bundle — a curated collection of 16 components that work together as a complete AI development harness. Installing kdco/workspace gives you:

  • 4 plugins (delegation, planning, notifications, worktrees)
  • 2 npm plugins (DCP, markdown table formatter)
  • 3 MCP servers (Context7, Exa, GitHub Grep)
  • 4 agents (researcher, coder, scribe, reviewer)
  • 4 skills (plan protocol, code review, code philosophy, frontend philosophy)
  • 1 command (/review)
  • Orchestrator configurations for plan/build/explore agents
  • Permission boundaries (webfetch deny, agent sandboxing)

Architecture

┌──────────────────────────────────────────────────────────┐
│                     ORCHESTRATORS                        │
│         ┌──────┐                    ┌───────┐            │
│         │ plan │                    │ build │            │
│         └──┬───┘                    └───┬───┘            │
└────────────┼────────────────────────────┼────────────────┘
             │                            │
     ┌───────┴───────┐            ┌───────┴───────┐
     ▼       ▼       ▼            ▼       ▼       ▼
┌─────────────────────────────────────────────────────────┐
│                      SPECIALISTS                        │
│  ┌─────────┐ ┌────────────┐ ┌───────┐ ┌──────┐ ┌──────┐ │
│  │ explore │ │ researcher │ │ coder │ │scribe│ │review│ │
│  └─────────┘ └────────────┘ └───────┘ └──────┘ └──────┘ │
└─────────────────────────────────────────────────────────┘
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 Async delegation system
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
Bundle philosophy Code + frontend philosophy skills
MCP context7 Library documentation lookup
MCP exa Web search for external research
MCP gh_grep 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

Advanced: Direct Install (No Profile)

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

If you don't have OCX installed, install it from the OCX repository.

Owning Your Code

This repository preserves a snapshot of the former bundle. Fork it, modify the agents, tune the skills, make it yours. That's the point of OCX.

Maintenance

This V1 code is retired. Source synchronization and active maintenance have ended. Repository history and existing releases remain available for reference and forks.

Disclaimer

This project is not built by the OpenCode team and is not affiliated with OpenCode in any way.

License

MIT

About

Bundled multi-agent orchestration harness for OpenCode. One install, complete control.

Topics

Resources

Stars

587 stars

Watchers

6 watching

Forks

Releases

Packages

Contributors

Languages