storkit/.story_kit/specs/functional/SLACK_SETUP.md

Slack Integration Setup

Bot Configuration

Slack integration is configured via bot.toml in the project's .story_kit/ directory:

transport = "slack"
display_name = "Storkit"
slack_bot_token = "xoxb-..."
slack_signing_secret = "..."
slack_channel_ids = ["C01ABCDEF"]

Slack App Configuration

Event Subscriptions

1. In your Slack app settings, enable Event Subscriptions.
2. Set the Request URL to: https://<your-host>/webhook/slack
3. Subscribe to the message.channels and message.im bot events.

Slash Commands

Slash commands provide quick access to pipeline commands without mentioning the bot.

1. In your Slack app settings, go to Slash Commands.
2. Create the following commands, all pointing to the same Request URL: https://<your-host>/webhook/slack/command

Command	Description
/storkit-status	Show pipeline status and agent availability
/storkit-cost	Show token spend: 24h total, top stories, and breakdown
/storkit-show	Display the full text of a work item (e.g. /storkit-show 42)
/storkit-git	Show git status: branch, changes, ahead/behind
/storkit-htop	Show system and agent process dashboard

All slash command responses are ephemeral — only the user who invoked the command sees the response.

OAuth & Permissions

Required bot token scopes:

• chat:write — send messages
• commands — handle slash commands