╔═══════════════════════════════════════════════════════════════════════════════════════════════════════════════╗
║                                                                                                               ║
║                                                                                                               ║
║⠀⠀  ⠀⠀⠀⠀⠀⠀⠀⣰⣿⣿⣿⡆⢀⣤⣤⣤⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀                                                                        ║
║⠀⠀⠀  ⠀⠀⠀⠀⠀⢠⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⢀⣀⣤⣀⠀⠀⠀⠀⠀                                                                         ║
║⠀  ⠀⠀⠀⠀⠀⠀⢀⣿⣿⣿⣿⠿⢿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⣀⡀⠀⠀                                                                         ║
║⠀⠀  ⠀⠀⠀⠀⠀⣼⣿⣿⣿⡟⢀⣿⣿⣿⣿⡟⢻⣿⣿⣿⣿⣿⣿⣿⣷⡄⠀           ▀██                     ▀██                  ▀██  ▄█▄       ║
║⠀⠀  ⠀⠀⢠⠆⢰⣿⣿⣿⣿⠁⣼⣿⣿⣿⡿⠀⣼⣿⣿⣿⠿⢿⣿⣿⣿⠇⠀     ▄▄▄▄   ██   ▄▄▄▄   ▄▄ ▄▄ ▄▄    ██ ▄▄▄    ▄▄▄▄    ▄▄ ██  ███       ║
║⠀  ⠀⠀⠀⣿⠀⣾⣿⣿⣿⡟⢰⣿⣿⣿⣿⠃⣸⣿⣿⣿⠏⢠⣿⣿⣿⡿⠀⠀     ██▄ ▀  ██  ▀▀ ▄██   ██ ██ ██   ██▀  ██ ▄█▄▄▄██ ▄▀  ▀██  ▀█▀       ║
║⠀  ⠀⠀⢸⡇⢠⣿⣿⣿⡿⠀⣾⣿⣿⣿⠇⢠⣿⣿⣿⡏⢠⣿⣿⣿⣿⠁⠀     ▄ ▀█▄▄  ██  ▄█▀ ██   ██ ██ ██   ██    █ ██      █▄   ██   █        ║
║⠀  ⠀⠀⣾⣧⡈⠛⢿⣿⠃⣸⣿⣿⣿⡏⢠⣿⣿⣿⡟⢀⣾⣿⣿⣿⠃⠀⠀⠀    █▀▄▄█▀ ▄██▄ ▀█▄▄▀█▀ ▄██ ██ ██▄  ▀█▄▄▄▀   ▀█▄▄▄▀ ▀█▄▄▀██▄  ▄        ║
║⠀  ⠀⠀⠿⣿⣿⣶⣄⡉⠀⢿⣿⣿⡟⠀⣾⣿⣿⡿⢀⣾⣿⣿⡿⠁⠀⠀⠀⠀                                                              ▀█▀       ║
║⠀⠀  ⠀⠀⠈⠉⠛⠛⠛⠒⠀⠈⠉⠁⠸⠿⠿⠿⠃⠾⠿⠟⠋⠀⠀⠀⠀⠀                                                                         ║
║                                                                                                                ║
║                                                                                                                ║
║                                  🚀 GitHub Flow Automation & MCP Server 🚀                                     ║
║                                                                                                                ║
║                                     Git workflows that pack a punch! ✊                                        ║
║                                                                                                                ║
╚════════════════════════════════════════════════════════════════════════════════════════════════════════════════╝

Slambed MCP - Intelligent Development Assistant

Advanced MCP (Model Context Protocol) Server with AI-Powered Development Tools

An intelligent development assistant that combines AI-powered tools, real-time collaboration, predictive suggestions, and comprehensive project intelligence. Transform your development workflow with next-generation automation! 🚀

✨ Features

🧠 AI-Powered Intelligence

• Natural Language Interface - Universal slam tool accepts plain English commands
• Predictive Suggestions - Machine learning-powered recommendations based on usage patterns
• AI Commit Messages - Intelligent commit message generation from code changes
• Context-Aware Intelligence - Deep project understanding with multi-source analysis

🤝 Real-Time Collaboration

• Live Team Synchronization - Real-time presence and conflict resolution
• Shared Workspaces - Team chat, file locking, and collaborative editing
• Conflict Prevention - Operational transformation for seamless collaboration
• Team Activity Tracking - Comprehensive visibility into team workflows

⏰ Time Machine & Recovery

• State Snapshots - Automatic project state capture with compression
• Advanced Undo - Granular action history and intelligent rollback
• Recovery Points - Named savepoints for major workflow milestones
• Conflict Resolution - Smart handling of recovery conflicts

🛡️ Enterprise Security

• End-to-End Encryption - AES-256-GCM for sensitive data protection
• Role-Based Access Control - Granular permissions and user management
• Comprehensive Audit Logging - Security events and compliance tracking
• Multi-Factor Authentication - Secure session management

🔌 Universal Integration

• MCP Protocol - Native Claude Desktop integration
• IDE Extensions - VS Code, IntelliJ, Eclipse plugins
• CLI Interface - Backward-compatible command-line tools
• Web Dashboard - Browser-based project management
• API Access - RESTful APIs for custom integrations

📚 Learning & Personalization

• User Profiling - Personalized preferences and workflow patterns
• Adaptive Learning - System improves based on usage patterns
• Privacy Controls - Configurable data collection and anonymization
• Custom Shortcuts - Personalized aliases and command shortcuts

🚀 Quick Start

Prerequisites

• Node.js 18+
• Git
• Claude Desktop (for MCP integration)

Installation

1. Clone the repository:

git clone https://github.com/your-username/slambed-mcp.git
cd slambed-mcp

2. Install dependencies:

npm install

3. Set up environment variables:

cp .env.example .env
# Edit .env with your API keys (see Configuration section)

4. Configure Claude Desktop MCP:

Add to your Claude Desktop ~/.claude/config.json:

{
  "mcpServers": {
    "slambed-mcp": {
      "command": "node",
      "args": ["./src/index.js"],
      "cwd": "/path/to/slambed-mcp",
      "env": {
        "ANTHROPIC_API_KEY": "your_key_here",
        "OPENAI_API_KEY": "your_key_here",
        "PERPLEXITY_API_KEY": "your_key_here"
      }
    }
  }
}

5. Start the server:

npm start

First Use - Natural Language Commands

# Universal natural language interface
slam("show me the current project status")
slam("create a new feature branch for user authentication") 
slam("generate an AI commit message for my changes")
slam("deploy to staging environment")
slam("start a team collaboration session")

📋 Available Commands

🎯 Smart Mode (NEW!)

• slambed - Interactive mode with context-aware suggestions
• slambed --quick - Automatically perform the most likely action

⚡ Simplified Commands (NEW!)

• slambed commit - Smart commit workflow with AI message generation
• slambed pr - Create pull request from current branch
• slambed sync - Sync current branch with main
• slambed status - Show repository status
• slambed publish - Publish package to npm
• slambed feature <name> - Start a new feature branch

🤖 Automation Workflows

• slambed auto commit - Complete workflow: branch → format → lint → commit → push → PR → merge
• slambed auto quick - Quick commit with smart defaults
• slambed auto smart - Analyze changes and suggest commit message
• slambed auto sync - Sync current branch with target
• slambed auto publish - Automated npm publishing

🚀 GitHub Actions

• slambed auto create-pr-workflow - Create PR check workflow (lint, test, build)
• slambed auto create-release-workflow - Create automated release workflow

🌿 GitHub Flow

• slambed flow start <name> - Start a new branch from main
• slambed flow finish - Create PR for current branch
• slambed flow quick <name> - Quick: branch + commit + PR
• slambed flow sync - Sync current branch with main
• slambed flow cleanup - Clean up merged branches

🔧 Utilities

• slambed util info - Repository information
• slambed util analyze - Change analysis
• slambed util health - Repository health check
• slambed util branches - List and categorize branches

🛡️ Branch Protection

• slambed protection enable - Enable branch protection with required status checks
• slambed protection disable - Remove branch protection
• slambed protection status - Check protection status
• Options:
  • -b, --branch <branch> - Branch to protect (default: main)
  • --no-pr-reviews - Don't require PR reviews
  • --no-status-checks - Don't require status checks
  • -c, --contexts <contexts...> - Required status checks (default: lint, test, build)
  • -a, --approvals <count> - Required approving reviews (default: 0)

🎯 Examples

Simplest Workflow Ever

# Start your work
slambed feature user-auth

# Make your changes...
# Then just run:
slambed

# Slambed detects you have changes and suggests committing
# Select "🚀 Commit changes" and you're done!

One-Command Workflow

# Made some changes? Just run:
slambed --quick

# Slambed automatically:
# - Detects your changes
# - Creates a feature branch if needed
# - Generates an AI commit message
# - Pushes and creates a PR
# - Auto-merges when checks pass

Natural Commands

# Commit your work
slambed commit

# Ready to ship?
slambed pr

# Stay in sync
slambed sync

# Check status
slambed status

Custom Aliases

Create a .slambed-aliases file in your project or home directory:

# ~/.slambed-aliases
c=commit
p=pr
s=sync
ship=commit --no-merge
done=auto commit

Then use your shortcuts:

slambed c     # Same as: slambed commit
slambed ship  # Same as: slambed commit --no-merge

Complete Feature Development (Classic)

# Start feature, make changes, then auto-commit
slamb-flow start user-auth
# ... make your changes ...
slambed auto commit -m "Implement user authentication"

Project Initialization

# Initialize complete project with GitHub repo
slambed init-project --project-name "my-app" --description "My awesome app"

GitHub Actions Setup

# Create PR check workflow (lint, test, build)
slambed auto create-pr-workflow --name "CI Pipeline"

# Create automated release workflow
slamb-commit create-release-workflow --type "both"

Smart Development

# Let AI analyze your changes and suggest commits
slamb-commit smart --execute

🔧 Configuration

Create .slambed.json in your project:

{
  "gitFlow": {
    "defaultBranch": "main",
    "autoMerge": true,
    "allowOutdatedBase": false
  },
  "automation": {
    "runFormat": true,
    "runLint": true,
    "runTests": false
  }
}

Configuration Options

gitFlow.allowOutdatedBase (default: false)

Controls whether operations can proceed when the base branch (main/master) is outdated:

• false (default): Operations will fail if base branch is outdated and cannot be updated
• true: Operations will continue with warnings even if base branch is outdated

This is useful for:

• Offline work: Set to true when working without network access
• CI environments: May need true if CI has limited git access
• Strict workflows: Keep as false to ensure all work starts from latest base

Example scenarios:

# With allowOutdatedBase: false (default)
$ slambed auto commit
⚠️  Base branch (main) is 3 commits behind origin/main
  Fetched latest main from origin
  Attempting to update base branch...
  ✅ Successfully updated base branch
✓ Created branch: feature/add-authentication-2025-01-05

# With allowOutdatedBase: true
$ slambed auto commit
⚠️  Base branch (main) is 3 commits behind origin/main
⚠️  Could not update base branch due to network issue. Continuing anyway due to config...
✓ Created branch: feature/add-authentication-2025-01-05

🛠️ Installation

npm install -g slambed-mcp

Or clone and install locally:

git clone https://github.com/your-username/slambed-mcp.git
cd slambed-mcp
npm install
npm link

License

MIT