✴ ▄█▀ ███ ✴ claude-threads
✴ █▀ █ ✴ Mattermost & Slack × Claude Code
✴ ▀█▄ █ ✴
Bring Claude Code to your team. Run Claude Code on your machine, share it live in Mattermost or Slack. Colleagues can watch, collaborate, and run their own sessions—all from chat.
Think of it as screen-sharing for AI pair programming, but everyone can type.
- Real-time streaming - Claude's responses stream live to chat
- Multi-platform - Connect to multiple Mattermost and Slack workspaces simultaneously
- Concurrent sessions - Each thread gets its own Claude session, persisted across bot restarts
- Collaboration -
!inviteteammates to participate; they get added asCo-Authored-By:trailers on Claude's commits - Permission modes - Three-way control over Claude's tool-use:
default(every action prompts for 👍/✅/👎 approval via emoji),auto(Claude's classifier auto-approves low-risk; high-risk still prompts — recommended), orbypass(no prompts, all tools allowed). Set via config,--permission-modeCLI flag, or in-session with!permissions default|auto|bypass. - Claude posts back to chat - Claude can call
send_fileto drop screenshots, generated PDFs, plots, or audio directly into the thread, andread_postto follow a Mattermost or Slack permalink the user shares - Git worktrees - Isolate Claude's changes in a branch with
!worktree feature/foo; supportslist,switch,remove,cleanup,off - File attachments - Drop images, PDFs, archives, or any file into the chat; Claude reads them from disk via its own
Read/Bash tools (100 MB cap) - Chrome automation - Optional integration with Claude in Chrome for web tasks
- Multi-account Claude (opt-in) - Round-robin sessions across multiple Claude subscriptions or API keys with automatic rate-limit cooldown — see Configuration
- Auto-update - Bot checks npm for new versions and offers to restart;
!update now/!update defercontrols the timing
# Install (pick one)
bun install -g claude-threads # with Bun (recommended)
npm install -g claude-threads # with Node
# Run the setup wizard
cd /your/project
claude-threadsThe interactive setup wizard will guide you through everything:
- Configure Claude Code CLI (if needed)
- Set up your Mattermost or Slack bot
- Test credentials and permissions
- Get you up and running in minutes
Need help with platform setup? See the Setup Guide for Mattermost or Slack bot creation.
- Bun 1.2.21+ or Node 20+ - Install Bun or Install Node
- Claude Code CLI working - test with
claude --version(needs API key or subscription)
Mention the bot in your chat:
@claude help me fix the bug in src/auth.ts
Type !help in any session thread:
| Command | Description |
|---|---|
!help |
Show available commands |
!release-notes |
Show what changed in the running version |
!context |
Show context usage |
!cost |
Show token usage and cost |
!compact |
Compress context to free up space |
!cd <path> |
Change working directory (restarts Claude) |
!permissions <mode> |
Set permission mode: default / auto / bypass |
!mentions [on|off] |
Quiet mode: only respond when @mentioned (bare !mentions toggles) |
!worktree <branch> |
Create and switch to a git worktree (also: list, switch, remove, cleanup, off) |
!plugin <list|install|uninstall> [name] |
Manage Claude Code plugins (restarts Claude) |
!invite @user |
Invite a user to this session (added as Co-Authored-By: on commits) |
!kick @user |
Remove an invited user |
!github-email <email> |
Register your GitHub noreply email so !invite can attribute commits to you |
!update |
Show auto-update status (!update now / !update defer) |
!bug <desc> |
Report a bug with context (creates a GitHub issue) |
!approve |
Approve pending plan (alternative to 👍 reaction) |
!escape |
Interrupt current task (session stays active) |
!stop |
Stop this session |
!kill |
Emergency shutdown (kills ALL sessions and exits the bot) |
Permission approval - When Claude wants to execute a tool:
- 👍 Allow this action
- ✅ Allow all future actions
- 👎 Deny
Plan approval - When Claude creates a plan:
- 👍 Approve and start
- 👎 Request changes
Questions - React with 1️⃣ 2️⃣ 3️⃣ 4️⃣ to answer multiple choice
Session control - ⏸️ to interrupt, ❌ or 🛑 to stop, ↩️ to resume a timed-out session
Drop any file into the chat (image, PDF, archive, source, log, you name it). The bot saves it to a per-thread directory and prepends the path to your message; Claude reads it with its own Read tool (full multimodal for images and PDFs) or processes it via Bash. Single 100 MB cap per file. Need to extract a zip? Claude runs unzip itself.
Going the other way, Claude can post files back into the thread (screenshots, generated PDFs, plots, MP3s) by calling the send_file MCP tool. Path is validated against the session working directory; auto-approved so the user doesn't have to 👍 every screenshot.
!invite @colleague # Let them participate
!kick @colleague # Remove access
Unauthorized users can request message approval from the session owner with a 👍 reaction.
Invited collaborators are added as Co-Authored-By: trailers on any commits Claude makes during the session. Each collaborator runs !github-email <their-noreply-address> once (find yours at https://github.com/settings/emails) and the bot remembers it across sessions.
Paste a Mattermost or Slack permalink in the thread and Claude can resolve it to the post body (and optional thread context) via the read_post MCP tool, instead of asking you to copy-paste. Auto-approved; scoped to channels the bot can already see.
Keep your main branch clean while Claude works on features:
@claude on branch feature/add-auth implement user authentication
Or mid-session: !worktree feature/add-auth
Restrict who can use the bot during setup (or reconfigure later with claude-threads --setup).
Leave the allowed users list empty to let anyone in the channel use the bot (be careful!)
- Setup Guide - Step-by-step setup for Mattermost and Slack
- Configuration Reference - Technical details and architecture
npm install -g claude-threadsThe bot checks for updates automatically and notifies you when new versions are available.
Apache-2.0