threads

---
name: threads
description: List and navigate watercooler threads. Use to see active discussions, find specific threads, or get an overview of project threads.
allowed-tools:
  - ToolSearch
  - mcp__watercooler__watercooler_list_threads
  - mcp__watercooler__watercooler_read_thread
---

# List and Navigate Threads

Arguments: $ARGUMENTS

## Modes

- **No arguments**: List all threads grouped by status
- **`open`** or **`closed`**: Filter by status
- **`<topic>`**: Show specific thread details
- **`--raw`**: Show full JSON response

## Steps

### Mode 1: List All Threads (no arguments or status filter)

1. **Load tool**:
   ```
   ToolSearch: select:mcp__watercooler__watercooler_list_threads
   ```

2. **Execute**:
   ```
   mcp__watercooler__watercooler_list_threads()
   ```

3. **Present results**:
   - Group by status (OPEN first, then CLOSED)
   - Show: topic, title, last activity, ball holder
   - Highlight actionable threads (where Claude has the ball)

### Mode 2: Show Specific Thread (topic provided)

1. **Load tool**:
   ```
   ToolSearch: select:mcp__watercooler__watercooler_read_thread
   ```

2. **Execute** (use `summary_only=true` to keep response under ~500 tokens):
   ```
   mcp__watercooler__watercooler_read_thread(topic="<topic>", summary_only=true)
   ```

3. **Present**:
   - Thread metadata
   - Recent entries summary
   - Current ball holder
   - Offer to fetch full entries if the user needs more detail

### Mode 3: Filter by Status

1. Parse status from arguments (case-insensitive: `open`/`OPEN`, `closed`/`CLOSED`)
2. List all threads using `watercooler_list_threads` (same as Mode 1)
3. Filter results client-side by matching the thread `status` field
4. Present filtered list using the same format as Mode 1

### `--raw` Flag

When `--raw` is present (in any mode), show the full JSON response after the
human-readable summary. This is consistent with the `recall` skill behavior.

## Example Invocations

- `/threads` - List all threads
- `/threads open` - Show only open threads
- `/threads mcp-migration` - Show specific thread details
- `/threads --raw` - Full JSON output