Claude Code Mattermost Plugin

Integrate Claude Code AI assistant directly into Mattermost for AI-powered coding sessions in your team chat.

Features

• 🤖 Native Mattermost Integration - Use slash commands instead of separate UI
• 💬 Interactive Messages - Approve/reject code changes with buttons
• 📁 File Operations - Browse and edit files via Mattermost dialogs
• 🔄 Real-time Updates - WebSocket connection for instant responses
• 📱 Mobile-Friendly - Works on Mattermost mobile apps

Quick Start

Prerequisites

• Mattermost Server 9.0+
• Go 1.21+
• Node.js 22+
• Docker & Docker Compose (for development)

Development Setup

1. Clone the repository:

   git clone https://github.com/appsome/claude-code-mattermost-plugin.git
   cd claude-code-mattermost-plugin

2. Install dependencies:

   # Backend (Go modules will download automatically)
   cd server && go mod download && cd ..
   
   # Frontend
   cd webapp && npm install && cd ..

3. Start development environment:

   make dev

   This will start Mattermost at http://localhost:8065

4. Build the plugin:

   make build

5. Create plugin bundle:

   make bundle

6. Upload to Mattermost:

   • Go to System Console → Plugins → Management
   • Upload dist/co.appsome.claudecode.tar.gz
   • Enable the plugin

Available Commands

make build        # Build plugin for current platform
make build-all    # Build for all platforms
make test         # Run tests
make bundle       # Create plugin bundle
make dev          # Start development environment
make dev-down     # Stop development environment
make clean        # Remove build artifacts

Usage

Once installed, use these slash commands in any channel:

Session Management

• /claude-start [project-path] - Start a new coding session
• /claude-stop - Stop the current session
• /claude-status - Show current session status

Communication

• /claude <message> - Send a message to Claude Code
• /claude-thread [action] - Add thread context to Claude's session
  • /claude-thread - Add thread messages as context
  • /claude-thread summarize - Add context and ask Claude to summarize
  • /claude-thread implement - Add context and ask Claude to implement
  • /claude-thread review - Add context and ask Claude to review

File Operations

• /claude-files - Browse and manage project files
• /claude-new-file <path> - Create a new file

Help

• /claude-help - Show detailed help information

Project Status

✅ Issue #2: Project Setup & Scaffolding - COMPLETE
✅ Issue #3: Bridge Server - COMPLETE
✅ Issue #4: Slash Commands & Bot Integration - COMPLETE
✅ Issue #5: Interactive Message Components - COMPLETE
✅ Issue #9: Thread Context Integration - COMPLETE
🔄 Issue #6: File Explorer & File Operations - IN REVIEW (PR #11)
⏳ Issue #7: Testing & Documentation - IN PROGRESS
⏳ Issue #8: Deployment & CI/CD - PENDING

See Issues for the full roadmap.

Documentation

• Development Guide - Coming soon
• Architecture - Coming soon
• Contributing - Coming soon

Project Structure

claude-code-mattermost-plugin/
├── server/              # Go backend
│   ├── plugin.go       # Main plugin entry
│   ├── commands.go     # Slash command handlers
│   └── ...
├── webapp/             # React frontend
│   ├── src/
│   │   └── index.tsx   # Plugin entry point
│   └── package.json
├── plugin.json         # Plugin manifest
├── Makefile           # Build automation
├── docker-compose.yml # Development environment
└── README.md

License

GPL-3.0 - See LICENSE for details

Support

• GitHub Issues
• Documentation

Credits

Built by Appsome
Inspired by claudecodeui