╔═══════════════════════════════════════════════════════════════════════════════════════════════════════════════╗
║ ║
║ ║
║⠀⠀ ⠀⠀⠀⠀⠀⠀⠀⣰⣿⣿⣿⡆⢀⣤⣤⣤⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ ║
║⠀⠀⠀ ⠀⠀⠀⠀⠀⢠⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⢀⣀⣤⣀⠀⠀⠀⠀⠀ ║
║⠀ ⠀⠀⠀⠀⠀⠀⢀⣿⣿⣿⣿⠿⢿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⣀⡀⠀⠀ ║
║⠀⠀ ⠀⠀⠀⠀⠀⣼⣿⣿⣿⡟⢀⣿⣿⣿⣿⡟⢻⣿⣿⣿⣿⣿⣿⣿⣷⡄⠀ ▀██ ▀██ ▀██ ▄█▄ ║
║⠀⠀ ⠀⠀⢠⠆⢰⣿⣿⣿⣿⠁⣼⣿⣿⣿⡿⠀⣼⣿⣿⣿⠿⢿⣿⣿⣿⠇⠀ ▄▄▄▄ ██ ▄▄▄▄ ▄▄ ▄▄ ▄▄ ██ ▄▄▄ ▄▄▄▄ ▄▄ ██ ███ ║
║⠀ ⠀⠀⠀⣿⠀⣾⣿⣿⣿⡟⢰⣿⣿⣿⣿⠃⣸⣿⣿⣿⠏⢠⣿⣿⣿⡿⠀⠀ ██▄ ▀ ██ ▀▀ ▄██ ██ ██ ██ ██▀ ██ ▄█▄▄▄██ ▄▀ ▀██ ▀█▀ ║
║⠀ ⠀⠀⢸⡇⢠⣿⣿⣿⡿⠀⣾⣿⣿⣿⠇⢠⣿⣿⣿⡏⢠⣿⣿⣿⣿⠁⠀ ▄ ▀█▄▄ ██ ▄█▀ ██ ██ ██ ██ ██ █ ██ █▄ ██ █ ║
║⠀ ⠀⠀⣾⣧⡈⠛⢿⣿⠃⣸⣿⣿⣿⡏⢠⣿⣿⣿⡟⢀⣾⣿⣿⣿⠃⠀⠀⠀ █▀▄▄█▀ ▄██▄ ▀█▄▄▀█▀ ▄██ ██ ██▄ ▀█▄▄▄▀ ▀█▄▄▄▀ ▀█▄▄▀██▄ ▄ ║
║⠀ ⠀⠀⠿⣿⣿⣶⣄⡉⠀⢿⣿⣿⡟⠀⣾⣿⣿⡿⢀⣾⣿⣿⡿⠁⠀⠀⠀⠀ ▀█▀ ║
║⠀⠀ ⠀⠀⠈⠉⠛⠛⠛⠒⠀⠈⠉⠁⠸⠿⠿⠿⠃⠾⠿⠟⠋⠀⠀⠀⠀⠀ ║
║ ║
║ ║
║ 🚀 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
git clone https://github.com/your-username/slambed-mcp.git
cd slambed-mcp
npm install
- Set up environment variables:
cp .env.example .env
- 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"
}
}
}
}
npm start
First Use - Natural Language Commands
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
slambed feature user-auth
slambed
One-Command Workflow
slambed --quick
Natural Commands
slambed commit
slambed pr
slambed sync
slambed status
Custom Aliases
Create a .slambed-aliases file in your project or home directory:
c=commit
p=pr
s=sync
ship=commit --no-merge
done=auto commit
Then use your shortcuts:
slambed c
slambed ship
Complete Feature Development (Classic)
slamb-flow start user-auth
slambed auto commit -m "Implement user authentication"
Project Initialization
slambed init-project --project-name "my-app" --description "My awesome app"
GitHub Actions Setup
slambed auto create-pr-workflow --name "CI Pipeline"
slamb-commit create-release-workflow --type "both"
Smart Development
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:
$ 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
$ 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