Send an attachment#
broco roster --json
broco say visual-check "Describe the layout in this image." --worker codex --model MODEL_FROM_ROSTER --attach ./screen.png --bg --json
broco wait visual-check
broco done visual-check --result pass --why "Layout check complete."Repeat --attach for multiple files. Paths are resolved from the sending terminal’s directory (~/ paths expand automatically). Files are copied into broco’s project data before acceptance so queued turns never depend on the original file staying unchanged. Up to 8 attachments are accepted (20 MiB each, 32 MiB total). Follow-ups with attachments queue for the next turn. Unsupported or unknown input capabilities are rejected before dispatch.
What each transport accepts#
| CLI / current transport | Delivery and limits |
|---|---|
claude print / stream-json |
Passes prompts over stdin and supports text, image, and pdf attachments via --add-dir and the Read tool (rejects audio and video). |
| Codex app-server | Sends images as localImage input blocks and supports localAudio when the selected model reports audio support. codex exec fallback uses repeated --image and rejects audio instead of dropping it. |
agy stdin / stream-json |
Passes prompts via stdin and supports all five input modalities (text, image, audio, video, pdf) when supported by the selected model. |
pi RPC |
Sends images content blocks (type, base64 data, mimeType). Its input, contextWindow, and maxTokens fields supply exact metadata without parsing rounded tables. |
cursor-agent print |
No direct media attachment flag is documented for the headless print adapter; media input remains unknown and explicit attachments are rejected. |
custom:<name> templates |
Templates pass text arguments or stdin; explicit media attachments remain unknown and are rejected. |
Official OpenAI app-server input documentation, pi RPC documentation, agy headless input, Cursor CLI parameters, Gemini file tools, OpenCode CLI.
Limits and descriptions#
Use broco roster --worker WORKER --json --full for token limits and their sources. Compact output keeps capabilities.input; when grouped variants disagree, it reports unknown until you inspect the exact variant.
CLI-reported limits take precedence over the catalog. Values sourced only from the catalog are marked catalog-api-limit (an API ceiling, not a subscription guarantee). Missing values remain unknown. See the roster for local ~/.broco/models.json overrides.