mirror of https://github.com/coleam00/Archon synced 2026-04-21 13:37:41 +00:00

Rasmus Widing 392a13ab90 fix(docs): address review findings from PR #734

- Fix stale port 3000 → 3090 in ngrok/Cloudflare tunnel commands
- Fix workflow names to use actual archon- prefixed names throughout README
- Split ralph into ralph-fresh and ralph-stateful variants
- Fix "Future: workflow definitions" → actual shipped feature label
- Fix directory structure to show project-centric layout (not legacy)
- Add missing TELEGRAM_ALLOWED_USER_IDS documentation
- Add docs/adapters/slack.md for consistent adapter doc pattern
- Update README platform table to link to new slack adapter doc

2026-03-19 09:02:42 +01:00

1.2 KiB

Raw Blame History

Slack Setup

Connect Archon to Slack so you can interact with your AI coding assistant from any Slack workspace.

Prerequisites

Archon server running (see Getting Started)
A Slack workspace where you have permission to install apps

Quick Setup

Slack uses Socket Mode — no public URL or webhooks needed. Works behind firewalls.

For the full step-by-step guide (app creation, permissions, token generation), see the detailed Slack setup guide.

Set Environment Variables

SLACK_BOT_TOKEN=xoxb-your-bot-token
SLACK_APP_TOKEN=xapp-your-app-token

Configure User Whitelist (Optional)

To restrict bot access to specific users:

In Slack, go to a user's profile > click "..." > "Copy member ID"
Add to environment:

SLACK_ALLOWED_USER_IDS=U01ABC123,U02DEF456

When set, only listed user IDs can interact with the bot. When empty/unset, the bot responds to all users.

Configure Streaming Mode (Optional)

SLACK_STREAMING_MODE=batch  # batch (default) | stream

For streaming mode details, see Advanced Configuration.

1.2 KiB Raw Blame History