Release index

broco / v1.0.0 / Release notes

Changelog

What changed for workers, hosts, and tickets, and how to upgrade.
Version

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-init Start & Multi-Host Open Skill:
    • broco setup detects 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 open SKILL.md into ~/.agents/skills/broco/ with automatic host syncing for Claude Code, Codex, Cursor, Antigravity, OpenCode, and Pi (linking ~/.pi/agent/skills/broco and respecting PI_CODING_AGENT_DIR).
    • Works in any directory immediately after setup using your global policy — state stays in ~/.broco/ keyed by realpath(gitRoot || cwd), leaving your repositories untouched.
    • Optional L1 broco init remains available for per-repo strict allowlists, concurrency caps, repo rules, or heavy manager mode (--manager-mode). init defaults to maintaining a marked AGENTS.md section (--host supports auto|agents|claude|codex|cursor|agy|opencode|pi) and touches CLAUDE.md only when already present or when --host claude is specified.
  • Built-in Symmetric claude Worker & Recursion Guard:
    • Added native claude worker adapter (claude -p --output-format stream-json + --resume, stdin prompt passing, unified failure classification, and secret redaction) alongside codex, agy, cursor-agent, pi:<provider>, and custom:<name>. Any host agent can now dispatch to any worker symmetrically.
    • Added hard recursion protection: every worker subprocess inherits BROCO_IN_WORKER=1, and broco refuses nested worker-to-worker dispatch by default unless explicitly overridden with --allow-nested.
  • Default Cross-Vendor Blind Review:
    • broco review <name> now makes --by optional: when omitted, it automatically picks a permitted worker from a different vendor with available quota headroom.
  • Dynamic Local Timezone & Brand Refresh:
    • Replaced hardcoded Asia/Shanghai timestamps 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.
  • Unified Naming & Lossless Migration:
    • Renamed package, CLI, data directory, project marker, and env vars to broco, ~/.broco/, .broco/, and BROCO_*.

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.

Version

0.4.1

  • Agent-First CLI Ergonomics:
    • say reads multi-line or backtick-heavy prompts from --file <path>, --file -, or stdin (- or piped input) without shell-escaping friction or ps argv 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) and cc-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) and show (--compact, --turn, plus batch --status and --full), batch-level cc-bro retry <prefix> for failed/stopped shards, map --inputs-file <path|->, roster --global, stats --project, init --project, ~/ path expansion, and --json across setup, ui, and shutdown.
  • Runtime, SQLite & Lifecycle Optimization:
    • Event-driven /wait wakes immediately (0ms) via microtask-coalesced Projects notifications instead of 140ms SQLite polling, returning task, cwd, worktree, branch and changedFiles alongside the turn result.
    • Rewrote Store.ticketRows, batchDetail and ticketRecords into constant-count batched SQLite queries (BEGIN IMMEDIATE write transactions, indexed timelines, microtask-coalesced queue/SSE broadcasts, bulk { type: 'tickets' } SSE frames, and async live git file tracking) — 150-shard map + board queries run in ~260ms.
    • Orphan-free worker and service lifecycle: SIGTERM/SIGINT aborts and reaps active workers while preserving queued turns; done, uninit and a 10-minute idle timer release idle pi RPC processes; 0700 UID-verified socket directory with seamless 0.4.0 legacy socket upgrade guard; Linux /proc platform backend; full secret redaction across native/stream/template workers; and sanitized PATH / npm_config_prefix handling in setup and install-local.sh.
  • Board UI & Quota Polish:
    • Upgraded the Svelte 5 board (100dvh independent column scroll, 50-card Done cap, search and batch/outcome filters) with live map batch progress bars, [index/count] shard badges and sibling shard switcher, queue badges, multi-task history, collapsed Asia/Shanghai (UTC+8) timelines, problem/context callouts, accurate runningCount pulse, auto-restored web_port across runner restarts, agy secondary-group quota warnings, and full agy catalog picks.

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).

Version

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 on wait, native agy stdin prompts + /usage quota + 5-modality attachments, direct Agent-First configuration commands (set, allow, deny, defaults, note, rules, hide, unhide) with Asia/Shanghai audit log and cc-bro undo, init/uninit CLAUDE.md markers, cc-bro --version, runner crash/signal recovery tracking, and loopback credential proxies (proxy-open, proxy-list, proxy-close).
Version

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 --attach delivers 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 --full for exact variants, limits and full metadata, or --worker ID to 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.

Version

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. say and review accept --effort and 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.

Version

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#

  1. Let any work you want to keep running finish. If you have notes in a manager room, keep that folder for reference.
  2. Install with npm install -g cc-bro@0.2.0. If an old runner is active, use the new cc-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.
  3. Run cc-bro setup. In the actual project root, run cc-bro init and 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.

Version

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.