broco / v1.0.0 / Release notes
Changelog
1.0.0
opus-manager / cc-bro is now broco — a cross-harness collaboration CLI that lets your local coding agents work together using your existing official CLI logins.
- L0 Zero-
initStart & Multi-Host Open Skill:broco setupdetects installed, signed-in CLIs on your machine, asks you once to confirm a global allowlist (never enables workers silently), prints a live quota-aware roster immediately, and installs one openSKILL.mdinto~/.agents/skills/broco/with automatic host syncing for Claude Code, Codex, Cursor, Antigravity, OpenCode, and Pi (linking~/.pi/agent/skills/brocoand respectingPI_CODING_AGENT_DIR).- Works in any directory immediately after
setupusing your global policy — state stays in~/.broco/keyed byrealpath(gitRoot || cwd), leaving your repositories untouched. - Optional L1
broco initremains available for per-repo strict allowlists, concurrency caps, repo rules, or heavy manager mode (--manager-mode).initdefaults to maintaining a markedAGENTS.mdsection (--hostsupportsauto|agents|claude|codex|cursor|agy|opencode|pi) and touchesCLAUDE.mdonly when already present or when--host claudeis specified.
- Built-in Symmetric
claudeWorker & Recursion Guard:- Added native
claudeworker adapter (claude -p --output-format stream-json+--resume, stdin prompt passing, unified failure classification, and secret redaction) alongsidecodex,agy,cursor-agent,pi:<provider>, andcustom:<name>. Any host agent can now dispatch to any worker symmetrically. - Added hard recursion protection: every worker subprocess inherits
BROCO_IN_WORKER=1, andbrocorefuses nested worker-to-worker dispatch by default unless explicitly overridden with--allow-nested.
- Added native
- Default Cross-Vendor Blind Review:
broco review <name>now makes--byoptional: when omitted, it automatically picks a permitted worker from a different vendor with available quota headroom.
- Dynamic Local Timezone & Brand Refresh:
- Replaced hardcoded
Asia/Shanghaitimestamps with dynamic local timezone resolution (BROCO_TZ→TZ→ system timezone →UTC) across CLI output, audit entries, proxy expiry, and the local board. - Shipped the 16-bit pixel broccoli visual identity across the README, website, docs, favicons, and local board.
- Replaced hardcoded
- Unified Naming & Lossless Migration:
- Renamed package, CLI, data directory, project marker, and env vars to
broco,~/.broco/,.broco/, andBROCO_*.
- Renamed package, CLI, data directory, project marker, and env vars to
Upgrade from cc-bro (0.4.x) or opus-manager#
Wait for any active work you want to keep (cc-bro status if still installed), install broco, then run broco shutdown and broco setup. broco setup detects existing ~/.cc-bro/ state and running legacy runners and walks you through lossless migration to ~/.broco/ without disturbing ticket history. See the upgrade guide.
0.4.1
- Agent-First CLI Ergonomics:
sayreads multi-line or backtick-heavy prompts from--file <path>,--file -, orstdin(-or piped input) without shell-escaping friction orpsargv exposure.- Added
cc-bro status [--project PATH] [--all] [--json]to inspect runner health, protocol compatibility, web URL, active credential proxies, active/queued tickets, batches and cleanable worktrees without auto-starting an offline runner. - Added
cc-bro diff <name> [--stat] [--json](tracked + untracked changes against the ticket's base commit) andcc-bro clean [name|prefix] [--dry-run] [--delete-branch] [--force] [--json](safe worktree + orphaned attachment cleanup). - Added context-saving filters on
ls(--active,--status,--flag,--batch,--limit) andshow(--compact,--turn, plus batch--statusand--full), batch-levelcc-bro retry <prefix>for failed/stopped shards,map --inputs-file <path|->,roster --global,stats --project,init --project,~/path expansion, and--jsonacrosssetup,ui, andshutdown.
- Runtime, SQLite & Lifecycle Optimization:
- Event-driven
/waitwakes immediately (0ms) via microtask-coalescedProjectsnotifications instead of 140ms SQLite polling, returningtask,cwd,worktree,branchandchangedFilesalongside the turn result. - Rewrote
Store.ticketRows,batchDetailandticketRecordsinto constant-count batched SQLite queries (BEGIN IMMEDIATEwrite transactions, indexed timelines, microtask-coalesced queue/SSE broadcasts, bulk{ type: 'tickets' }SSE frames, and async livegitfile tracking) — 150-shardmap+ board queries run in ~260ms. - Orphan-free worker and service lifecycle:
SIGTERM/SIGINTaborts and reaps active workers while preserving queued turns;done,uninitand a 10-minute idle timer release idlepiRPC processes;0700UID-verified socket directory with seamless0.4.0legacy socket upgrade guard; Linux/procplatform backend; full secret redaction across native/stream/template workers; and sanitizedPATH/npm_config_prefixhandling insetupandinstall-local.sh.
- Event-driven
- Board UI & Quota Polish:
- Upgraded the Svelte 5 board (
100dvhindependent column scroll, 50-card Done cap, search and batch/outcome filters) with livemapbatch progress bars,[index/count]shard badges and sibling shard switcher, queue badges, multi-task history, collapsedAsia/Shanghai(UTC+8) timelines, problem/context callouts, accuraterunningCountpulse, auto-restoredweb_portacross runner restarts,agysecondary-group quota warnings, and fullagycatalogpicks.
- Upgraded the Svelte 5 board (
Upgrade from 0.4.0 or earlier#
Check cc-bro status, let active work you want to keep finish, then run cc-bro shutdown and cc-bro setup. Version 0.4.1 uses runner protocol 14 (cc-bro shutdown cleanly stops protocols 4–13, including 0.4.0 legacy /tmp sockets).
0.4.0
- Added per-project FIFO concurrency pools (
--concurrency,cc-bro set concurrency), sharded batch fan-out (cc-bro map),cc-bro retry, optional turn onwait, nativeagystdin prompts +/usagequota + 5-modality attachments, direct Agent-First configuration commands (set,allow,deny,defaults,note,rules,hide,unhide) withAsia/Shanghaiaudit log andcc-bro undo,init/uninitCLAUDE.mdmarkers,cc-bro --version, runner crash/signal recovery tracking, and loopback credential proxies (proxy-open,proxy-list,proxy-close).
0.3.1
- The roster discovers all installed, signed-in CLI models and pi providers. Project permissions still apply. Hide model families globally or per project to remove them from the manager's roster and reject dispatch, including queued starts.
- Model descriptions, tiers, grades and task picks ship in the package. Override entries by ID in
~/.cc-bro/models.json. The skill checks input capabilities first, honors user notes and rules, and flags research older than 60 days. - Model inputs are intersected with the CLI's actual transport. CLI-reported context and output limits take precedence over catalog API ceilings; missing data stays unknown.
say --attachdelivers supported images through native Codex or pi, with snapshots preserved for queued turns. - Each bro can have a global default model and effort, with project overrides. The roster and Settings show effective defaults; subsequent dispatches use them without changing other CLI settings.
- Text and JSON rosters are compact by default. Denied bros contain only ID and permission; effort/fast variants share one row, and catalog-labeled older models are folded. Use
--fullfor exact variants, limits and full metadata, or--worker IDto inspect one bro. Notes and rules remain intact. - Bilingual Docs cover model capabilities, attachments, catalog overrides, hiding, defaults and compact queries.
Upgrade from 0.3.0#
Install cc-bro@0.3.1, then run cc-bro shutdown and cc-bro setup to refresh the runner and skill. Let work you want to finish complete first: shutdown stops running and queued turns across all projects on that runner. Existing settings, sessions and tickets are preserved. JSON consumers should use roster --json --full when they need detailed model fields. Denied bros no longer expose models even in full mode; user-hidden models stay hidden. See the upgrade guide.
0.3.0
- A live project roster exposes permitted CLIs, models, effort levels, detected defaults, login, capabilities, rules and user notes. The Claude Code skill reads it before choosing a bro.
sayandreviewaccept--effortand can change models between completed turns. - Built-in agy and cursor-agent workers join native Codex and pi. They resume by explicit session ID and queue active follow-ups. Cache is shown only when the CLI reports it. Every backend can use worktrees and participate in linked reviews.
- Custom CLI templates provide new-session and resume commands, reply/ID extraction and optional model/effort arguments. A real two-turn memory trial is required before saving. Gemini CLI and OpenCode are editable, degraded presets rather than unverified full adapters.
- The board has global and project Settings: read-only detection, install/update/login commands opened in Terminal, allowlists, defaults, notes and rules. Manager-proposed notes need user confirmation. Settings are stored only in cc-bro; credential-file values and other CLI configuration are untouched.
- The website adds bilingual roster, custom CLI and Settings guides.
Upgrade from 0.2.0#
Install cc-bro@0.3.0, then use the new cc-bro shutdown and rerun cc-bro setup. Wait first if you want active work to finish: shutdown cancels running and queued turns across the runner’s projects. Existing 0.2 policies, named sessions and ticket history are preserved; no new workers are allowed automatically. The old-runner shutdown path remains compatible with 0.1.0 and M2. See the upgrade guide.
0.2.0
Breaking: the manager room is gone#
Open Claude Code in the project itself. The separate manager folder, its local skill and the board’s provider settings were part of 0.1.0. The new user-level skill delegates from the chat you already use. The new registry does not import 0.1.0 tickets or manager notes.
Workers and tickets#
- Choose native Codex or a pi provider for each ticket. Register the allowed worker IDs and a default per project. Native Codex and pi using a Codex subscription are separate choices.
- Reuse a name to continue a session; use different names to run in parallel. A follow-up receipt says whether it reached the current turn, was queued for the next turn or was rejected.
- Start a ticket in a Git worktree or ask a different worker to review a completed turn. The board shows the branch, changed files, steps, linked reviews and reported input cache hits. Acceptance leaves the branch and worktree intact.
Upgrade from 0.1.0#
- Let any work you want to keep running finish. If you have notes in a manager room, keep that folder for reference.
- Install with
npm install -g cc-bro@0.2.0. If an old runner is active, use the newcc-bro shutdown. It stops running and queued work across that runner’s projects; unfinished turns do not resume automatically. Files already written stay on disk. - Run
cc-bro setup. In the actual project root, runcc-bro initand choose allowed workers and a default. Open Claude Code there and type/cc-bro. The old ticket database stays on disk.
See the upgrade walkthrough.
0.1.0
The first macOS preview paired each project with a separate Claude Code manager room. Named pi workers ran in the project and continued working when the manager chat closed.
- The setup board could install pi, connect a provider using a key or subscription, and set the default worker model.
- Tickets moved through Queued, Working, Review and Done. The CLI could send follow-ups, show history, wait for a turn or stop a worker. The local board showed progress across projects.