StealthChat - Slack Plugin BETA

Overview

The Slack plugin connects one or more Slack workspaces directly inside StealthChat. Send and receive messages in public channels, private channels you're a member of, direct messages (im), and group DMs (mpim) - all from the unified buddy list. Tokens are scoped per workspace, and you can connect as many workspaces as you need.

Note: The Slack plugin is currently in Beta. Messaging, OAuth, and multi-workspace flows are stable; please report any issues through Bug Reports.

Adding a Workspace (OAuth)

  1. Open Buddy List → Slack → Slack Settings → Add Workspace
  2. A browser window opens to your Slack workspace's sign-in / approval page
  3. Sign in and approve the install
  4. The browser returns you to StealthChat and the workspace begins populating in the buddy list

Once approved, the workspace stays signed in across launches. You can remove a workspace at any time via the trash icon next to it.

Adding a Workspace (Bot Token)

If your workspace admin gave you a Slack token directly (a xoxb- bot token or a xoxp- user token), you can skip the browser flow entirely. Paste the token into Slack Settings → Add by Token and the workspace is added immediately.

Need Approval From Your Workspace Admin?

If your Slack workspace requires admin approval for new apps, share the install link so your admin can approve StealthChat for the whole org in a single step:

  1. Open Slack Settings → Share with Workspace Admins
  2. Click Copy Link
  3. Send the link to your Slack workspace admins

Settings Reference

Connected Workspaces

Add Workspace Open OAuth in browser
Workspace Status Per-workspace status: ● Connected or ● Disconnected
Trash Icon Remove a workspace (confirmation prompt)

Startup

Auto-connect on startup Automatically connect to Slack when StealthChat opens

Notifications

Desktop notifications Show notifications for new Slack messages

Display Options

Show channels in buddy list Display Slack channels in the sidebar
Show DMs in buddy list Display Slack direct messages in the sidebar

Share with Workspace Admins

Install Link Share this link with workspace admins to install StealthChat
Copy Link Copies the install URL to your clipboard

Messaging Features

Channels

  • Public + private channels (where you're a member)
  • When sending in a public channel you're not in, Stealth auto-joins (not_in_channel recovery)
  • Channel list synced per workspace

Direct Messages

  • 1:1 DMs (im)
  • Group DMs (mpim)
  • Live presence per workspace

Composer

  • Send text messages
  • Optional thread reply via thread_ts
  • Standard StealthChat composer features

Polling & Notifications

  • 2-second polling round-robin for new messages across tracked channels and DMs
  • Desktop notifications respect the Notifications toggle
  • Notifications skip when StealthChat is focused

Multi-Workspace

Each connected workspace shows up as its own group in the buddy list with the workspace name as the section header. Channels and DMs are namespaced per workspace so two workspaces with the same channel name (for example #general) never collide. The Slack Settings window lists every connected workspace with its current connection status:

● Connected Token is valid, polling is active, and messages are flowing
● Disconnected Token is invalid or has been revoked - re-authorize via Add Workspace

Workspaces persist across restarts. Removing a workspace via the trash icon disconnects it and clears its saved sign-in.

Tokens & Storage

  • Per-workspace sign-in tokens are stored only on your machine
  • OAuth tokens are bound to the scopes you approved during the install
  • Bot tokens (xoxb-) are useful for shared bot installs; user tokens (xoxp-) act on your behalf
  • Removing a workspace deletes its entry - revoke the token from Slack's Manage Apps page if you want to fully invalidate it server-side
  • Tokens are never transmitted to Stealth's servers after the initial OAuth handshake completes
  • Workspaces persist across restarts and reconnect automatically when Auto-connect on startup is enabled

Multi-View

Note: Slack does NOT yet have a dedicated multi-view window. Use individual Slack chat windows for now. Multi-view support is on the roadmap.

Privacy & Limits

  • Slack tokens are stored only on your local machine
  • Slack rate-limits apply to message history and posting; the plugin paces requests appropriately
  • The OAuth handshake briefly relays through Stealth's servers to complete sign-in; your tokens are not stored on Stealth's servers
  • Marked Beta - report issues via Bug Reports

Troubleshooting

  1. "Disconnected" workspace - click the workspace row and try Add Workspace again to refresh the token
  2. Browser doesn't open after Add Workspace - confirm your default browser handler is set
  3. Posting fails in a channel you're not a member of - StealthChat attempts to join automatically; if Slack still refuses, ask your workspace admin to widen the install scopes
  4. Browser tab closed before approval - reopen Slack Settings → Add Workspace to start the sign-in over
  5. Channels missing from buddy list - verify Show channels in buddy list is enabled in Slack Settings
  6. For persistent issues, see Bug Reports

Related Pages