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

claude-threads.run

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
File attachments - Attach images, PDFs, and files for Claude to analyze
Chrome automation - Control Chrome browser for web tasks

Quick Start

Install & Run

# 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-threads

The 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.

Prerequisites

Bun or Node 18+ - Install Bun or Install Node
Claude Code CLI working - test with claude --version (needs API key or subscription)

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
`!bug <desc>`	Report a bug with context
`!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 ❌

File Attachments

Attach files to your messages for Claude to analyze:

Type	Formats	Max Size
Images	JPEG, PNG, GIF, WebP	-
Documents	PDF	32 MB
Text	.txt, .md, .json, .csv, .xml, .yaml, source code	1 MB
Archives	.zip (auto-extracted, max 20 files)	50 MB
Compressed	.gz (auto-decompressed)	-

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

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!)

Documentation

Setup Guide - Step-by-step setup for Mattermost and Slack
Configuration Reference - Technical details and architecture

Updates

npm install -g claude-threads

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

License

Apache-2.0