The default output is compact in both text and JSON, backed by a shared 45-second probe cache (--refresh forces a re-probe; --global inspects global defaults outside a registered repo). Denied workers contain only their ID and allowed:false, even with --full, and skip subprocess probing. If an allowed worker is missing or signed out, top-level warnings prints the exact install or sign-in command.
broco roster
broco roster --global
broco roster --worker codex --json
broco roster --worker codex --json --full
broco say investigate "Explain the failing test." --worker codex --model MODEL_FROM_ROSTER --effort low --bg --jsonLive quotas and operational signals#
quota: Codex (account/rateLimits/read) andagy(/usage) report live 5-hour and weekly headroom, flaggingavoidwhen tight,plentifulwhen wide open, andtightGroupsfor secondaryagymodel buckets. CLIs without a usage endpoint showunreportedand rely on error-derived cooldown tracking (recentProblem).record: Real per-task pass/rework/fail counts frombroco done. Once a model has 3+ non-blocked tasks, your own record outranks catalog grades.capabilities.input: Confirmed intersection of model capability and CLI transport (text,image,audio,video,pdf). Check fortruebefore--attach.
Compact and detailed views#
Each current model family takes one row: a real detected model ID, confirmed inputs, tier/grade, reported effort choices, and one sentence. Effort and fast variants share a row (variantCount, fast). For agy, multi-effort families fold under their base family ID and map --effort automatically.
Models labeled previous generation, superseded, or being retired in the catalog fold into olderModels. Use --full (optionally with --worker ID) for exact variants, older models, token limits, and full catalog metadata. Hidden models stay hidden in both modes.
Allowlist, notes, rules, and overrides#
- The allowlist is a hard boundary checked at dispatch and before queued work starts.
- Agent-first CLI commands update
defaults,note,rules,hide, andunhideimmediately for subsequent dispatches, with full audit history and one-commandbroco undo. See Settings and undo. - Built-in
lib/model-catalog.jsonships in the package. Optional~/.broco/models.json(or$BROCO_HOME/models.json) merges overrides by exact modelid, plus rootpicksandeffort_advice:
{"models":[{"id":"gpt-6.1-sol","summary":{"en":"Our default coder."},"grade":"Team preferred"}]}Catalog entries older than 60 days or missing a valid as_of are flagged stale. Advisory catalog grades never override user notes, rules, or your own stats. See Capabilities and media.