zag-cli 0.8.2

A unified CLI for AI coding agents — Claude, Codex, Gemini, Copilot, and Ollama
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

# zag broadcast

Send a message to all sessions in the current project.

## Synopsis

    zag broadcast "message"
    zag broadcast --tag <tag> "message"
    zag broadcast --global "message"
    echo "message" | zag broadcast --tag <tag>

## Description

`zag broadcast` sends a user message to all sessions in the current project. This is the multi-session counterpart to `zag input` — while `input` targets exactly one session, `broadcast` delivers the same message to every session in scope.

Use `--tag` to narrow the broadcast to only sessions with a specific tag. Use `--global` to broadcast across all projects.

The command resolves all matching sessions, sends the message to each one sequentially, and reports a summary of sent/failed counts.

If called from within a zag session (detected via `ZAG_SESSION_ID`), the message is automatically wrapped with sender metadata and reply instructions, just like `zag input`. Use `--raw` to skip wrapping.

## Options

### `<message>`

The message text to send. If omitted, the message is read from stdin.

### `--tag <TAG>`

Filter target sessions by tag. When specified, only sessions with this tag receive the message. Tags are matched case-insensitively. When omitted, all sessions in scope are targeted.

### `--global`

Search across all projects instead of only the current project.

### `-o, --output <FORMAT>`

Output format for the broadcast result:

- **text** (default): Human-readable summary printed to stderr (e.g., `> Sent to 3 sessions (0 failed)`)
- **json**: Compact JSON with per-session results and summary
- **json-pretty**: Pretty-printed JSON

JSON output structure:

```json
{
  "results": [
    {"session_id": "abc-123", "status": "sent"},
    {"session_id": "def-456", "status": "failed", "error": "session not found"}
  ],
  "summary": {"sent": 1, "failed": 1, "total": 2}
}
```

### `-r, --root <PATH>`

Root directory for session resolution.

### `--raw`

Send the message without agent-to-agent envelope wrapping. By default, when `zag broadcast` is called from within a zag session, the message is wrapped with sender metadata. Use `--raw` to send the message verbatim.

## Examples

    # Broadcast to all sessions in the current project
    zag broadcast "report your status"

    # Broadcast only to sessions tagged "backend"
    zag broadcast --tag backend "report your status"

    # Cross-project broadcast
    zag broadcast --global "deploy completed"

    # Cross-project broadcast filtered by tag
    zag broadcast --tag backend --global "deploy completed"

    # Pipe from stdin
    echo "standup time" | zag broadcast --tag team

    # JSON output with per-session results
    zag broadcast --tag backend "status" -o json

    # Pretty-printed JSON output
    zag broadcast "status" -o json-pretty

    # Send without agent envelope wrapping
    zag broadcast --tag backend --raw "plain message"

## Provider Support

Broadcast uses each session's provider-native resume mechanism. All providers that support `run_resume_with_prompt` are supported (Claude, Codex, Gemini, Copilot). Streaming is not supported for broadcast.

## See Also

    zag man input     Send to a single session
    zag man listen    Tail session output in real-time
    zag man session   List/inspect sessions
    zag man ps        List and manage agent processes