Skip to content

docs: Add Slack local development setup guide#2181

Closed
inkeep[bot] wants to merge 2 commits intomainfrom
docs-writer-ai-update-2026-02-19T21-32-29-988Z
Closed

docs: Add Slack local development setup guide#2181
inkeep[bot] wants to merge 2 commits intomainfrom
docs-writer-ai-update-2026-02-19T21-32-29-988Z

Conversation

@inkeep
Copy link
Contributor

@inkeep inkeep bot commented Feb 19, 2026

Summary

This PR adds documentation for setting up local Slack development using Socket Mode, as requested by @miles in Slack.

Changes

New file

  • agents-docs/content/talk-to-your-agents/slack/local-development.mdx — A comprehensive guide for developers to set up their own personal Slack app for local development

Updated file

  • agents-docs/content/talk-to-your-agents/slack/meta.json — Added the new page to sidebar navigation

What's documented

  • Why one app per developer — Socket Mode distributes events randomly; sharing an app splits events between developers
  • Quick setup (pnpm setup-slack-dev) — Automated script handling app creation, token collection, OAuth install, and .env configuration
  • Manual setup — Step-by-step alternative using the canonical app manifest
  • Verification steps — How to confirm Socket Mode is running
  • Architecture overview — How Socket Mode compares to production HTTP transport
  • Troubleshooting — Common issues with missing tokens, HMR restarts, missing events, etc.

Source material

Based on:

  • packages/agents-work-apps/src/slack/README.md
  • scripts/setup-slack-dev.ts

cc @miles for review

@changeset-bot
Copy link

changeset-bot bot commented Feb 19, 2026

⚠️ No Changeset found

Latest commit: a7a3fd4

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@vercel
Copy link

vercel bot commented Feb 19, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
agents-api Ready Ready Preview, Comment Feb 19, 2026 9:38pm
agents-docs Ready Ready Preview, Comment Feb 19, 2026 9:38pm
agents-manage-ui Ready Ready Preview, Comment Feb 19, 2026 9:38pm

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant