Skip to content

[EPIC] Claude Code Mattermost Plugin #1

@ada-evorada

Description

@ada-evorada

Epic: Claude Code Mattermost Plugin

Overview

Create a Mattermost plugin that replaces the Claude Code CLI/Desktop UI layer with interactive Mattermost messages, providing a native Mattermost experience for AI-powered coding sessions.

Goals

  1. Replace UI Layer: Use Mattermost interactive messages instead of web UI
  2. Reuse Server Code: Adapt server code from claudecodeui
  3. Native Integration: Slash commands, interactive posts, dialogs, and bot interactions
  4. Session Management: Manage Claude Code/Cursor/Codex sessions directly in Mattermost
  5. File Operations: Browse, edit, and commit code via Mattermost dialogs

Architecture

┌─────────────────┐
│   Mattermost    │
│     Server      │
└────────┬────────┘
         │
         ├─ Plugin Backend (Go)
         │   └─ Session Manager
         │   └─ Claude Code CLI Bridge
         │   └─ File/Git Operations
         │
         └─ Plugin Frontend (React)
             └─ Interactive Messages
             └─ Dialogs
             └─ Slash Command UI

Technology Stack

Mattermost Plugin:

  • Backend: Go (Mattermost plugin API)
  • Frontend: React (for interactive components)
  • Communication: WebSocket + REST

Claude Code Bridge:

  • Adapted from claudecodeui server (Node.js/Express)
  • Claude Code/Cursor CLI/Codex/Gemini integration
  • Session and project management

Features

Phase 1: Core Integration

  • Slash commands (/claude, /claude-start, /claude-stop)
  • Session lifecycle management
  • Basic chat interaction via bot messages

Phase 2: Interactive UI

  • Interactive message buttons (approve/reject changes)
  • File explorer via Mattermost dialogs
  • Code diff viewing in posts
  • Session status indicators

Phase 3: Advanced Features

  • Git operations (commit, push, branch)
  • Multi-session management
  • Project selection and switching
  • Collaborative sessions (multiple users, one agent)

Phase 4: Pro Features

  • Thread-based conversations
  • Code snippet attachments with syntax highlighting
  • MCP (Model Context Protocol) support
  • TaskMaster AI integration

Success Criteria

  1. ✅ Can start/stop Claude Code sessions from Mattermost
  2. ✅ Full conversation flow via Mattermost messages
  3. ✅ File operations without leaving Mattermost
  4. ✅ Git commits directly from chat
  5. ✅ Session persistence across Mattermost restarts
  6. ✅ Mobile-friendly (Mattermost mobile apps)

Timeline

  • Phase 1 (Core): 2 weeks
  • Phase 2 (Interactive UI): 2 weeks
  • Phase 3 (Advanced): 2 weeks
  • Phase 4 (Pro): 2 weeks

Total: ~8 weeks with 1 developer

Related Projects

Dependencies

  1. Mattermost Server (v9.0+)
  2. Claude Code CLI (or Cursor CLI / Codex / Gemini)
  3. Node.js 22+ (for bridge server)
  4. Go 1.21+ (for plugin backend)

Issues

This epic tracks the following implementation phases:

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions