heretek-ai/agency-control-plane
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
The Fleet Control Plane runs coding workers (OpenCode v2 servers) in isolated Git / jj worktrees, lets a human steer a long-lived Director session from a chat sidebar, and gates every worker diff...
概要
The Fleet Control Plane runs coding workers (OpenCode v2 servers) in isolated Git / jj worktrees, lets a human steer a long-lived Director session from a chat sidebar, and gates every worker diff behind an Ed25519 signature from a pinned human key. One dark-mode WebUI shows the whole fleet through five UX pillars. Requirements: Bun 1.4.2, Git, and the opencode CLI (v2, opencode serve) on PATH with a provider configured. Optional: a NATS server with JetStream. Dispatcher flags (also documented in the header of dispatcher/src/main.ts): 1. Messages go to one long-lived OpenCode session (agent director) started in the repository with its own isolated OpenCode database. The reply is shown in chat. Cards are created only from a fenced block the Director emits, validated with zod (strict; unknown fields, bad deps, or invalid JSON create nothing and are reported in chat): tasks [{"key":"api","title":"Query API","objective":"…","paths":["src/api/"],"acceptance":["…
README
以下は原文 README の抜粋です。原文を見る。
Agency Control Plane — Fleet Dispatcher Daemon + High-Fidelity WebUI
The Fleet Control Plane runs coding workers (OpenCode v2 servers) in
isolated Git / jj worktrees, lets a human steer a long-lived Director
session from a chat sidebar, and gates every worker diff behind an
Ed25519 signature from a pinned human key. One dark-mode WebUI shows the
whole fleet through five UX pillars.
Run it
Requirements: Bun 1.4.2, Git, and the opencode CLI (v2, opencode serve)
on PATH with a provider configured. Optional: a NATS server with
JetStream.
bun install --frozen-lockfile --ignore-scripts
# 1. The human approval key (once). Same format as epistemic-factory es-core:
# human.key.enc (scrypt + AES-256-GCM sealed Ed25519 key, 0600) + human.pub.
bun run keygen -- --out ~/.local/state/agency-control-plane
# Already have an es-core key? Point the dispatcher at it instead:
# --human-pub /path/to/human.pub (or put human.pub in the state dir).
# 2. Build the WebUI and start the dispatcher on the repository to work on.
bun run build:web
bun run dispatcher -- --repo /path/to/repo --port 7600
# (or `bun run serve -- --repo ...` to build and start in one go)
# 3. Open http://127.0.0.1:7600 — the UI and /api share one loopback origin.
Dispatcher flags (also documented in the header of dispatcher/src/main.ts):
| Flag / env | Default | Meaning |
|---|---|---|
--repo / FLEET_REPO |
cwd | Repository the fleet works on |
--state-dir / FLEET_STATE_DIR |
~/.local/state/agency-control-plane |
SQLite board + worktree register (dispatcher.db, WAL, busy_timeout=15000), worktrees/, audit.jsonl, human.pub |
--port / FLEET_PORT |
7600 |
Loopback port (never binds anything but 127.0.0.1) |
--human-pub |
/human.pub |
Pinned human public key. Missing or invalid → approvals are disabled and the approval routes answer 503 (fail closed) |
--worker-cmd / FLEET_WORKER_CMD |
opencode serve --port 0 --hostname 127.0.0.1 |
Worker server command (JSON array or words) |
--director-cmd / FLEET_DIRECTOR_CMD |
worker command | Director server command |
--director-agent |
director |
OpenCode agent of the Director session (define it in your OpenCode config) |
--task-agent |
server default | OpenCode agent for task sessions |
--fleet-cap |
4 |
Max concurrent workers (scheduler cap) |
--per-expert-cap |
fleet cap | Max concurrent workers per expert when its role pack sets no maxConcurrent |
--roles-dir / FLEET_ROLES_DIR |
unset | Role packs for expert tasks (see Role packs below) |
--tier-models / FLEET_TIER_MODELS |
unset | JSON {"tier-1-opencode": "provider/model", "tier-2-commercial": …, "tier-3-local": …}. New worker sessions run on the active tier’s model; unset tiers use the worker’s default model |
--task-timeout-ms |
30 min | Per-task worker timeout |
推奨ツール
別のキーワードを試すか、フィルタを外してください。
インストール
npx skillfish add heretek-ai/agency-control-plane