Slack

Talk to Hamster where your team already talks. @mention the bot in any channel or DM, drop files, run slash commands, cast alignment votes, and click Brief unfurls to read live work without leaving Slack.

Overview

The Slack Connection installs the Hamster bot in your workspace. Once connected, you can @mention Hamster in any channel or DM, send files for analysis, run slash commands, cast alignment votes, and read Briefs in the side panel without switching to the web app. The bot responds in threads, keeping channel noise low while giving you access to your Briefs, Tasks, and project context.

Hamster lives where the team already talks. A teammate can @mention the bot in the channel where the conversation is already happening and the bot creates a Hamster Chat thread with the right context — no copy-pasting into the web app, no "let me write that up later." Specs and questions that used to die in Slack threads now flow into Hamster as Briefs.

The Connection uses OAuth. A workspace admin installs the bot once, and each team member verifies their identity so the bot knows which Hamster account to use.

What You Can Do

  • Ask questions — @mention Hamster in a channel or DM to ask about your Briefs, Tasks, or project context. The bot searches your workspace Knowledge and responds in a thread.
  • Create Briefs — Describe what you want to build and the bot walks you through the Brief creation flow, asking clarifying questions before writing the Brief.
  • Drop files — Attach PDFs, Word docs, spreadsheets, images, or code files alongside your message and the bot analyzes them as part of the conversation.
  • Read Briefs in Slack — Click any Brief unfurl card to open the side panel. Headings, lists, code blocks, and bold text render natively, exactly as the author wrote them in the web app.
  • Vote on alignment — Brief cards and side panels let teammates mark a Brief Ready or Not yet from Slack. Each vote lands on the Brief Activity Timeline.
  • Auto-post Briefs — Pick a primary channel and Hamster can post new Briefs there automatically as Slack cards.
  • Run slash commands — Use /hamster help, /hamster logout, and /hamster feedback directly from any channel or DM.
  • Deliver with Cloud Agents — When a Cloud Agent is configured, use the Agent's slash command flow to deliver a Brief into the right repo from Slack.
  • Receive updates — When Hamster needs your input during a flow (clarifying questions, alignment votes), the bot asks you in the same Slack thread.

How to Connect

The Connection is a two-step flow: a workspace admin installs the bot once, then each user verifies their account.

Step 1 — Install the bot (workspace admin)

Only a Slack workspace admin can install the bot. The bot is installed once for the entire workspace.

  1. In Hamster Studio, go to Workspace Settings > Connections.
  2. Find Slack and click Connect.
  3. You're redirected to Slack's authorization page. If you belong to multiple workspaces, pick the right one from the dropdown.
  4. Approve the requested permissions.
  5. You're returned to Hamster — the bot is now installed in your workspace.

Step 2 — Each user verifies their account

The bot is installed once per workspace, but each team member must link their Slack identity to their Hamster account before the bot will respond.

  1. In Slack, open a DM with @Hamster and send any message.
  2. The bot replies with a verification link.
  3. Click the link — you're taken to Hamster's verification page.
  4. Click Connect my account.
  5. The bot confirms in the same thread: "Your account is now connected!"

If you @mention the bot from a public channel before verifying, the verification link is sent as a private DM rather than posted publicly. A short message in the channel directs you to check your DMs.

Verification links expire after 15 minutes. If yours expires, send another message and the bot will issue a fresh one.

How It Works

Channel mentions and DMs

@mention the Hamster bot in any channel and the bot starts a thread for the response. Reply in that thread and the bot continues the conversation with full context — Slack messages from the thread are passed through as context, so the bot understands what the team was discussing.

DMs work the same way without the @mention requirement. Use them for private queries that don't need to be visible to the rest of the workspace.

File attachments

Drop files alongside your message and the bot analyzes them. Supported formats include PDF, Word, Excel, plain text, images, and code files. Each message can carry up to 8 files at 50 MB each.

Files must be sent with message text — file-only messages aren't supported. Oversized files are skipped with a private message back to you listing what was skipped.

Brief side panel and alignment

When Hamster posts a Brief link into Slack, the unfurl card is clickable. Click it and Slack opens a side panel with the full Brief body — the same content the author sees in the web app, formatted as markdown with headings, lists, and code blocks intact. The panel reads the live document state, so what you see in Slack matches what's in Hamster right now.

The side panel also carries alignment actions. Mark the Brief Ready or Not yet, change its status when you have permission, or post a note. Each update lands on the Brief Activity Timeline, tied to the same version everyone sees in Hamster.

Primary channel and auto-posting

Admins can choose a primary Slack channel from the Slack Connection settings. When auto-posting is enabled, Hamster posts new Briefs to that channel as cards so stakeholders can read, vote, and follow the work from Slack.

Turn auto-posting off when you want Briefs to appear only when someone explicitly shares them. The channel picker and auto-post toggle save automatically.

Slack Search and Slack Agent

Slack appears as two related Connections:

  • Slack Search lets the AI search Slack context when answering questions, refining Briefs, or running Research Agents.
  • Slack Agent is the bot surface that handles mentions, DMs, Brief cards, alignment actions, and slash commands.

Threading and formatting

The bot uses threads for all responses, so a single channel can host multiple Hamster conversations without crossover. The bot maintains context within a thread for multi-turn conversations.

Responses are converted to Slack's mrkdwn format. Lists, bold text, links, and code blocks render natively. While Hamster is processing your request, you'll see progressive status messages so you know it's working — these are removed once the response is ready.

Slash Commands

These also work as plain-text commands in DMs and assistant threads (where Slack blocks slash commands).

  • /hamster help — Show available commands.
  • /hamster logout — Disconnect your Slack account from Hamster. Use this before linking to a different team account.
  • /hamster feedback <message> — Send product feedback directly to the Hamster team. Your message is submitted with your Slack and Hamster context attached. Feedback is rate-limited to 5 submissions per user per 24 hours.

When a Cloud Agent is configured for your Team, each Cloud Agent also gets its own slash command flow so you can deliver a Brief into a specific Cloud Agent directly from a channel.

Session Management

  • 30-day expiry — If you haven't messaged the bot in 30 days, your verification expires. Send a fresh message and the bot will issue a new verification link.
  • Team removal — If you're removed from the Hamster team, your Slack bot access is revoked automatically.
  • Switching accounts — Run /hamster logout (or type logout) before linking to a different Hamster team account.

Disconnecting

Disconnect the workspace (admin)

To remove the bot from your entire Hamster workspace:

  1. Go to Workspace Settings > Connections.
  2. Find Slack and click the overflow menu ().
  3. Click Disconnect.

This uninstalls the bot for everyone in the workspace and revokes all individual user sessions.

Remove a user's access

Removing a user from the Hamster team automatically revokes their Slack bot access — no manual steps required.

Security

  • Per-user verification — Each user must verify before the bot will respond. Unverified users get a verification link instead of a response.
  • Channel-safe verification — Verification links are never posted in public channels; they're sent via private DM.
  • Token encryption — All bot tokens are encrypted at rest.
  • Permissions parity — The bot can only access Briefs and Tasks visible to your Hamster account.
  • Membership cleanup — Bot access is automatically revoked when a user leaves the Hamster team.

FAQ

Do I need to reinstall if the bot stops responding? No. Bot tokens are recovered automatically. If the bot is unresponsive, check that the workspace is still connected under Workspace Settings > Connections, then verify your account is still active by running /hamster logout and re-verifying.

Can multiple Slack workspaces connect to one Hamster team? Each Slack workspace installation is linked to one Hamster account.

What if my verification link expired? Send another message to the bot — it will issue a new link.

Is there a cost for the Slack integration? No. It's included with Hamster Studio at no additional cost and uses the same AI processing as the web app.

Tips

  • @mention the bot in a thread to keep the conversation organized. Other team members can follow along without the bot cluttering the main channel.
  • Use DMs for quick personal queries — "what's my next Task?" or "show me the Briefs I'm working on."
  • Keep requests focused. "Create a Brief for the onboarding redesign" works better than a long paragraph mixing multiple topics.
  • Click Brief unfurls in Slack rather than copying the link — the side panel is faster than a context switch and stays in sync with the live document.

Related