# Aio Patch Control

> Scaffold a reference HTTP control-channel gateway (sample shell clients + bun TUI) into <project>/control/, OR print the control-channel protocol docs. Reference example based on the dirty-claude project (Phase 1 patched binary exposes HTTP+SSE server on 127.0.0.1:$DC_PORT inside the running Claude). NOT a generic abstraction — adapt to your own transport (WebSocket / ZMQ / named pipes) if needed.

- Skill: `aiocean/aio-patch-control` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add aiocean/aio-patch-control`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aiocean/aio-patch-control/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: aiocean (https://skillmd.com/u/aiocean)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/aiocean/aio-patch-control

---


# aio-patch-control — HTTP control-channel reference + docs

## Goal

Drop a working sample gateway into `<project>/control/` so you can drive your patched claude binary over HTTP/SSE *if* your patches.json injects an HTTP server (the dirty-claude pattern). Also expose the protocol docs.

## Usage

```
/aio-claude-toolkit:aio-patch-control scaffold     # copy sample scripts into ./control/
/aio-claude-toolkit:aio-patch-control docs         # print docs/control-channel.md
FORCE=1 /aio-claude-toolkit:aio-patch-control scaffold   # overwrite existing ./control/
```

## What scaffold ships

- `control/simple-client.sh`, `raw-client.sh` — minimal curl-based clients
- `control/stream-client.sh`, `stream-text.sh`, `stream-ambient.sh` — SSE streaming variants
- `control/interactive-client.sh` — line-oriented driver
- `control/client.ts` — bun TUI (richer UX)
- `control/README.md` — quick reference

## Requires

- Scaffolded project (walk-up sentinel) — your patches.json must inject an HTTP control-channel for these clients to actually talk to the binary
- For bun TUI: `bun` installed

## Implementation

Invokes `${CLAUDE_PLUGIN_ROOT}/skills/aio-patch-control/scripts/control.sh "$@"`.