Package Exports

claude-threads
claude-threads/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (claude-threads) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Claude Threads

 ✴ ▄█▀ ███ ✴   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.

Features

Real-time streaming - Claude's responses stream live to chat
Multi-platform - Connect to multiple Mattermost and Slack workspaces
Concurrent sessions - Each thread gets its own Claude session
Session persistence - Sessions survive bot restarts
Collaboration - Invite others to participate in your session
Interactive permissions - Approve Claude's actions via emoji reactions
Git worktrees - Isolate changes in separate branches
Image attachments - Attach images for Claude to analyze
Chrome automation - Control Chrome browser for web tasks

Quick Start

Prerequisites

Claude Code CLI installed and authenticated (claude --version)
Bun 1.2.21+ - Install Bun
Bot account - Mattermost or Slack

Install & Run

bun install -g claude-threads
cd /your/project
claude-threads

On first run, an interactive setup wizard guides you through configuration.

Use

Mention the bot in your chat:

@claude help me fix the bug in src/auth.ts

Session Commands

Type !help in any session thread:

Command	Description
`!help`	Show available commands
`!context`	Show context usage
`!cost`	Show token usage and cost
`!compact`	Compress context to free up space
`!cd <path>`	Change working directory
`!worktree <branch>`	Create and switch to a git worktree
`!invite @user`	Invite a user to this session
`!kick @user`	Remove an invited user
`!escape`	Interrupt current task
`!stop`	Stop this session

Interactive Controls

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

Cancel session - Type !stop or react with ❌

Collaboration

!invite @colleague    # Let them participate
!kick @colleague      # Remove access

Unauthorized users can request message approval from the session owner.

Git Worktrees

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

Access Control

Set allowedUsers in config to restrict who can use the bot:

platforms:
  - id: slack-team
    allowedUsers: [alice, bob, carol]

Empty list = anyone can use (be careful!)

Documentation

Mattermost Setup - Bot account setup for Mattermost
Slack Setup - Slack app setup with Socket Mode
Configuration Reference - All settings and options

Updates

bun install -g claude-threads

The bot checks for updates automatically and notifies you when new versions are available.

License

Apache-2.0