Skip to main content
Glama
emmahyde

deleg8

by emmahyde
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

deleg8 — Persistent omp Subagents Plugin

Makes oh-my-pi persistent subagents the default delegation mechanism in Claude Code. Bundles the deleg8 MCP server, an enforcement hook, and a skill that teaches the orchestrator when and how to use persistent subagents instead of bare task() calls.

Components

Component

Purpose

MCP server

deleg8 — wraps omp --mode rpc as named, persistent subagents (7 tools: spawn, send, output, status, list, stop, prune)

Hook

PreToolUse on task — blocks bare/unnamed task() spawns; forces descriptive agent_id via deleg8

Skill

deleg8 — teaches the orchestrator when deleg8 beats native subagents, with workflow patterns and jq output discipline

Related MCP server: claude-code-mcp

Install

cc --plugin-dir ~/projects/deleg8

Or install from the project:

cd ~/projects/deleg8
cc --plugin-dir .

Prerequisites

  • Bun ≥ 1.1.0 (brew install bun or curl -fsSL https://bun.sh/install | bash)

  • omp on PATH (or set OMP_BIN in settings)

  • Dependencies installed: bun install

Configuration

Create .claude/deleg8.local.md in your project (or ~/.claude/ for global):

---
omp_bin: /opt/homebrew/bin/omp
default_model:
  provider: deepseek
  modelId: deepseek-v4-pro
---

Field

Default

Description

omp_bin

omp (PATH lookup)

Path to omp binary

default_model.provider

deepseek

Model provider for deleg8 agents

default_model.modelId

deepseek-v4-pro

Model ID for deleg8 agents

Usage

Once installed, the skill loads on phrases like "fan out", "parallelize", "waves", "delegate", "subagents", or when the orchestrator considers spawning a bare task().

Basic fan-out:

spawn(agent_id="compiler", initial_prompt="Build the auth module")
spawn(agent_id="tester", initial_prompt="Write tests for auth", background=true)

Multi-turn refinement:

spawn(agent_id="impl", initial_prompt="Implement payment processor")
→ review output
send(agent_id="impl", message="Add retry logic for timeout failures")

Full workflow patterns: see the deleg8 skill output or references/when-to-use.md in the skill directory.

MCP Tools

Tool

Purpose

spawn

Launch a new omp agent with optional initial prompt

send

Send follow-up to existing agent (auto-resumes idle agents)

output

Read buffered frames — digest/summary/raw with jq projection

status

Check one agent's state (running/idle/dead)

list

Snapshot of all registered agents

stop

Abort, terminate, remove from registry

prune

Drop dead/idle agents from registry

Spawn Parameters (New in v0.2)

The spawn tool now supports these enforcement parameters:

Parameter

Type

Description

denylist

string[]

Regex patterns over tool commands. Prompt-level constraints + real-time violation monitoring. Note: omp runs Bash/Read/Edit internally — deleg8 cannot intercept before execution.

own

string[]

Glob patterns limiting write scope. Same injection + monitoring pattern. Same architectural constraint as denylist.

preamble

string

Shared context block every spawned agent receives before its prompt.

fallback_model

{provider, modelId}

If the primary model fails to apply (e.g. budget exceeded), try this one.

idle_ttl

number (ms)

Auto-reap idle agents after N ms of inactivity (registry-level, 0 = off).

dead_ttl

number (ms)

Auto-reap dead agents after N ms (registry-level, 0 = off).

exclusive

{pattern, wait}[]

Cooperative agent protocol — agents acquire/release locks via host tools. Voluntary: agents must call exclusive_acquire/exclusive_release.

Usage example:

spawn(
  agent_id="builder",
  initial_prompt="Compile the .csproj",
  denylist=["git (stash|checkout)", "dotnet test"],
  own=["src/**", "*.csproj"],
  preamble="Friflo: Tags getter returns a struct copy — use AddTag/RemoveTag",
  idle_ttl=300_000,
  exclusive=[{pattern: "dotnet build", wait: true}]
)

Host tools available to agents:

  • exclusive_acquire(pattern) — acquire an exclusive command lock

  • exclusive_release(pattern) — release an exclusive command lock

  • msg(text) — send IRC message back to orchestrator

  • task_create(label, note?) — create sub-task visible to orchestrator

  • task_update(task_id, status?, note?) — update sub-task status

Enforcement Hook

The PreToolUse hook on task evaluates every subagent spawn:

  • Allows: explore subagents (read-only scouting), tasks with descriptive role fields

  • Blocks: Bare task("do X") calls, unnamed/generic subagents

  • Blocked message: "Bare task() is banned. Use deleg8: spawn(agent_id='descriptive-name', initial_prompt='...')"

This server cannot be deployed

Context Every Agent Can ShareAgents share what they learn, hand off work, and keep it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • claude-octopus

    xiaolai
    A
    license
    A
    quality
    C
    maintenance
    Wraps the Claude Agent SDK as MCP servers, letting you spawn multiple specialized Claude Code agents — each with its own model, tools, system prompt, and personality — from any MCP client.
    5
    49 npm
    21
    ISC

  • claude-code-mcp

    xihuai18
    A
    license
    A
    quality
    D
    maintenance
    Wraps Claude Code as tools for MCP clients, enabling autonomous coding tasks via a 4-tool lifecycle with session management, async polling, and permission controls.
    4
    43 npm
    20
    MIT

  • claude-wrap-mcp

    Alex-Kaff
    A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that lets any MCP-capable agent spawn and drive Claude Code sessions — effectively turning Claude Code into an orchestratable sub-agent fleet.
    84 npm
    MIT

  • pi-delegate

    LarryStanley
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables Claude Code to delegate coding implementation and testing to a local pi agent via MCP tools, including dispatching task books, monitoring status, steering or aborting runs mid-execution, and retrieving results and transcripts.
    17 npm
    4
    MIT