sessions git:20260920.eee93c6A

Immutable. This exact content never changes and is served at /api/v1/blob/d00a58976851af9e.

---
name: sessions
description: >-
  Show the team's sessions: `/brigade:sessions` runs `brigade sessions` and prints its output unchanged, and
  `/brigade:sessions --all` includes the offline ones. Use it whenever the roster is being SHOWN to the user, so
  they see what the command printed rather than a retelling of it; reading the roster to address a message is
  `brigade:team-messaging` and its `--json` form.
user-invocable: true
argument-hint: "[--all]"
allowed-tools: Bash(brigade sessions:*)
---

# Show the team's sessions

`$ARGUMENTS` is whatever the user typed after the command name, and is empty when you reached for this skill
yourself rather than being sent here by `/brigade:sessions`. Either way the steps below are the whole of it.

1. If `$ARGUMENTS` is empty, run exactly `brigade sessions`. If it is `--all`, ignoring surrounding whitespace,
   run exactly `brigade sessions --all`. For anything else, say that `--all` is the only argument this skill
   takes, and stop — never a flag they did not type, never `--json`, never a second command.
2. If the command succeeded, print what it printed **verbatim**, inside a fenced block, and write nothing else.
   No table, no list, no counts, no summary, no "this session is …", no comparison with an earlier run, no remark
   about any session or its state. On the first use on a machine, a `brigade: first use: downloading …` line
   precedes the roster: print that too rather than editing the output. The command's output is the display;
   reformatting it is what this skill exists to stop.
3. If the command failed, print what it printed, verbatim, and stop. Do not run it again and do not offer
   another form of it.

Sending a message, reading the roster on your own initiative, and every other `brigade` verb belong to the
`brigade:team-messaging` skill. This one only shows what `brigade sessions` prints.