slack-thread

# Slack Thread Reader

Script to fetch Slack channel history, threads, and individual replies.
Output is LLM-friendly format: one message per line, ascending order (oldest→newest), minimal whitespace.

## Script Location

`scripts/slack-thread.sh` (entry point) → `scripts/slack-thread.py` (main logic)

## Slack Link Structure

```
https://abstract-im.slack.com/archives/C0AE4MGLNUU
                                        ^^^^^^^^^^^
                                        Channel ID

https://abstract-im.slack.com/archives/C0AE4MGLNUU/p1770775935866499
                                        ^^^^^^^^^^^  ^^^^^^^^^^^^^^^^
                                        Channel ID    Message ts (parent)

https://abstract-im.slack.com/archives/C0AE4MGLNUU/p1770776063826049?thread_ts=1770775935.866499&cid=C0AE4MGLNUU
                                        ^^^^^^^^^^^  ^^^^^^^^^^^^^^^^            ^^^^^^^^^^^^^^^^     ^^^^^^^^^^^
                                        Channel ID    Reply ts (child)           Parent ts            Channel ID (duplicate)
```

- **pTS**: Timestamp in URL path. `p` + 10 digits (seconds) + 6 digits (microseconds). API uses `seconds.microseconds` format (e.g., `p1770775935866499` → `1770775935.866499`)
- **thread_ts**: Parent message ts of the thread. If present, it's a reply link
- **cid**: Duplicate channel ID info (for app deep links, ignored by script)
- **ts**: Unique ID and timestamp of a Slack message. Unique within a channel

## Usage

### 3 Modes

| Link Format | Mode | Behavior |
|-----------|------|------|
| `/archives/CHANNEL` | Channel | Fetch channel history |
| `/archives/CHANNEL/pTS` | Thread | Fetch full thread with ts as parent |
| `/archives/CHANNEL/pTS?thread_ts=...` | Reply | Fetch single reply only |

### Read Thread
```bash
scripts/slack-thread.sh https://abstract-im.slack.com/archives/CHANNEL/pTIMESTAMP
scripts/slack-thread.sh <channel-id> <thread-ts>
```

### Read Channel History
```bash
scripts/slack-thread.sh https://abstract-...