How do I install the Ainb Fleet:broadcast skill?

Run npx skillmds@latest add stevengonsalvez/ainb-fleet-broadcast in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ainb Fleet:broadcast safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ainb Fleet:broadcast?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ainb Fleet:broadcast free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ainb Fleet:broadcast?

stevengonsalvez (@stevengonsalvez) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ainb Fleet:broadcast by stevengonsalvez

Name: Ainb Fleet:broadcast
Rating: 4.666666666666667 (3 reviews)
Author: stevengonsalvez

Ainb Fleet:broadcast

Fan out a single prompt to selected claude sessions across the fleet. Use when you need to apply the same instruction (e.g. `/clear`, `git pull`, `remote-control disconnect`) to many sessions at once. Routing: tmux send-keys by default (the broker is an opt-in fallback, toggled via AINB_FLEET_TRANSPORT). Refuses to run without an explicit targeting flag (--all, --filter <regex>, or --cwd <substring>) — no implicit fan-out.

File contents

ainb fleet:broadcast

Send one prompt to selected sessions. Mandatory targeting flag.

Run

ainb fleet broadcast "<prompt>" --all                       # every running session
ainb fleet broadcast "<prompt>" --filter "<regex>"          # match tmux/workspace name
ainb fleet broadcast "<prompt>" --cwd "<substring>"         # match cwd

Targeting flags (one required)

flag	matches against
`--all`	every session in `ainb fleet standup`
`--filter <regex>`	regex against `tmux_session` OR `workspace_name`
`--cwd <substring>`	substring against `cwd`

If none provided, the command exits with broadcast requires --all, --filter <regex>, or --cwd <substring> — by design, to prevent accidental fan-out.

Output

ainb fleet broadcast — sent to N target(s)
  ✓ <name> via tmux <tmux_session>
  ✓ <name> via broker peer <peer_id>
  ✗ <name>: <reason>

✓ via tmux = sent via tmux send-keys -l (literal mode, works for any tmux pane regardless of peer state) — this is the default path. ✓ via broker = sent through claude-peers HTTP — only seen when a target has no live tmux pane (or AINB_FLEET_TRANSPORT=peers is set).

Routing rule

Controlled by AINB_FLEET_TRANSPORT (default tmux-first). For each target:

Default (tmux-first):

If session has tmux_session and tmux says it exists → tmux send-keys -l.
Else if session has peer_id and broker is healthy → POST /send-message to broker.
Else → Failed { reason: "no live tmux session and no reachable broker peer" }.

tmux-only: step 1 only; never touches the broker. Failure reason notes (transport=tmux-only).

peers / broker (legacy): the old order — broker first, tmux fallback.

Common flows

Cycle a specific app:

ainb fleet broadcast "/clear" --filter "shotclubhouse"

Pull latest in every active worktree:

ainb fleet broadcast "git pull" --cwd "/agents-in-a-box/worktrees/"

Universal reset:

ainb fleet broadcast "/exit" --all   # careful — quits everything

Safety notes

tmux send-keys -l uses literal mode → shell metacharacters in the prompt are safe (no injection).
Multi-line prompts: newlines in the broadcast text get sent as literal characters; the receiving claude reads them as a single message.
The Enter key is sent after the literal text → claude sees the prompt as a submitted user message.

Verify a broadcast landed

For each target, tail the JSONL transcript:

ls -t ~/.claude/projects/<cwd-slug>/*.jsonl | head -1 | xargs grep "<prompt-text>"

(<cwd-slug> = replace / with - in the target's cwd.)

---name: ainb-fleet-broadcastdescription: Fan out a single prompt to selected claude sessions across the fleet. Use when you need to apply the same instruction (e.g. `/clear`, `git pull`, `remote-control disconnect`) to many sessions at once. Routing: tmux send-keys by default (the broker is an opt-in fallback, toggled via AINB_FLEET_TRANSPORT). Refuses to run without an explicit targeting flag (--all, --filter <regex>, or --cwd <substring>) — no implicit fan-out.---# ainb fleet:broadcastSend one prompt to selected sessions. Mandatory targeting flag.## Run```bashainb fleet broadcast "<prompt>" --all # every running sessionainb fleet broadcast "<prompt>" --filter "<regex>" # match tmux/workspace nameainb fleet broadcast "<prompt>" --cwd "<substring>" # match cwd```## Targeting flags (one required)| flag | matches against ||---|---|| `--all` | every session in `ainb fleet standup` || `--filter <regex>` | regex against `tmux_session` OR `workspace_name` || `--cwd <substring>` | substring against `cwd` |If none provided, the command exits with `broadcast requires --all,--filter <regex>, or --cwd <substring>` — by design, to preventaccidental fan-out.## Output```ainb fleet broadcast — sent to N target(s) ✓ <name> via tmux <tmux_session> ✓ <name> via broker peer <peer_id> ✗ <name>: <reason>````✓ via tmux` = sent via `tmux send-keys -l` (literal mode, works for anytmux pane regardless of peer state) — this is the default path.`✓ via broker` = sent through claude-peers HTTP — only seen when a targethas no live tmux pane (or `AINB_FLEET_TRANSPORT=peers` is set).## Routing ruleControlled by `AINB_FLEET_TRANSPORT` (default `tmux-first`). For each target:**Default (`tmux-first`):**1. If session has `tmux_session` and tmux says it exists → `tmux send-keys -l`.2. Else if session has `peer_id` and broker is healthy → POST `/send-message` to broker.3. Else → `Failed { reason: "no live tmux session and no reachable broker peer" }`.**`tmux-only`:** step 1 only; never touches the broker. Failure reason notes`(transport=tmux-only)`.**`peers` / `broker` (legacy):** the old order — broker first, tmux fallback.## Common flows**Cycle a specific app:**```bashainb fleet broadcast "/clear" --filter "shotclubhouse"```**Pull latest in every active worktree:**```bashainb fleet broadcast "git pull" --cwd "/agents-in-a-box/worktrees/"```**Universal reset:**```bashainb fleet broadcast "/exit" --all # careful — quits everything```## Safety notes- `tmux send-keys -l` uses literal mode → shell metacharacters in the prompt are safe (no injection).- Multi-line prompts: newlines in the broadcast text get sent as literal characters; the receiving claude reads them as a single message.- The Enter key is sent *after* the literal text → claude sees the prompt as a submitted user message.## Verify a broadcast landedFor each target, tail the JSONL transcript:```bashls -t ~/.claude/projects/<cwd-slug>/*.jsonl | head -1 | xargs grep "<prompt-text>"```(`<cwd-slug>` = replace `/` with `-` in the target's cwd.)

Frequently asked questions