| name | slack-thread |
| description | Read and summarize Slack channel history and thread conversations. Use when receiving a Slack link (https://...slack.com/archives/...), or when asked to view channel/thread messages, summarize conversations, or check recent messages in a channel. |
Slack Thread Reader
Script for fetching Slack channel history and thread replies.
Script Location
scripts/slack-thread.sh (entry point) → scripts/slack-thread.py (main logic)
Usage
Read Thread
scripts/slack-thread.sh https://your-workspace.slack.com/archives/CHANNEL/pTIMESTAMP
scripts/slack-thread.sh <channel-id> <thread-ts>
Read Channel History
scripts/slack-thread.sh https://your-workspace.slack.com/archives/CHANNEL
scripts/slack-thread.sh <channel-id>
scripts/slack-thread.sh <channel-id> --limit 30
Channel History with Thread Replies (Full)
scripts/slack-thread.sh <channel-id> --with-threads
Limit Thread Replies (Optional)
scripts/slack-thread.sh <channel-id> --with-threads --thread-limit 5
Workflow
- When given a Slack link or channel ID, use this script to fetch the conversation history.
- ⚠️ If the link type and the user's request don't match, always ask for clarification.
- Link format:
/archives/CHANNEL = channel, /archives/CHANNEL/pTIMESTAMP = thread
- Example: If the user provides a thread link but says "get the channel history" → "The link you provided points to a specific thread. Did you want the thread content or the entire channel history?"
- People make mistakes. If the link and the request don't match, ask instead of guessing.
- When asked to summarize channel history: Ask the user "Should I include thread replies?" and set the
--with-threads flag accordingly.
- Summarize or pass through the fetched content as-is.
Options
| Option | Description | Default |
|---|
--limit N | Number of channel history messages | 50 |
--with-threads | Include thread replies inline | off |
--thread-limit N | Max replies per thread (0=all) | 0 (all) |
Output Elements
| Element | Format | Example |
|---|
| Timestamp | ISO 8601 (seconds) | [2026-02-11T17:45:56] |
| Sender | Real name | John Doe: |
| Mentions | @name resolved | @Jane Smith |
| Emoji reactions | Emoji + reactor names | [:thumbsup: John,Jane] |
| Attachments | 📎 filename (type) | 📎 image.png (image/png) |
| Thread reply count | 💬N | 💬13 |
| Thread replies (inline) | ├ └ tree | with --with-threads |
Notes
- The bot must be a member of the target channel. If you get a
channel_not_found error, instruct the user to run /invite @botname in the channel.
- Without
--with-threads, channel history won't include thread conversations. Always confirm whether to include threads when summarizing.
