devsolo-tools

devsolo 🚀

AI-native Git workflow automation via Model Context Protocol (MCP) and native slash commands for Claude Code

devsolo is a powerful Claude Code plugin that streamlines Git workflows while maintaining clean, linear commit history. It provides structured validation, automated PR management, and seamless integration with GitHub through native slash commands and specialized sub-agents.

Features

• 🤖 AI-Native Design: Built exclusively for Claude Code with native plugin architecture
• ⚡ Slash Commands: Quick access via /devsolo commands in Claude Code
• 🚀 One-Command Workflow: Ship entire features in a single MCP tool call
• 🛡️ Structured Validation: Pre/post-flight checks with JSON results (no UI dependencies)
• 🚫 Branch Reuse Prevention: Blocks reusing branch names after merge
• ✓ PR Conflict Detection: Ensures single PR per branch lifecycle
• 📈 Linear History Enforcement: Ensures all merges result in clean, linear commit history
• 🔄 Session Management: Track multiple concurrent workflows with isolated sessions
• ⚙️ State Machine Control: Deterministic workflow states prevent invalid operations
• 🔗 GitHub Integration: Automatic PR creation, CI monitoring, and merging
• 🔒 Safety First: Built-in safeguards prevent accidental commits to main
• 📍 Smart Status Line: Always-visible workflow status in Claude Code

Installation

Option 1: Plugin Installation (Recommended) 🎯

Status: Coming soon - awaiting Claude Code marketplace

When the Claude Code marketplace becomes available, you'll be able to install with a single command:

/plugin install devsolo

This automatically:

• Installs the MCP server
• Registers all 13 slash commands
• Configures the sub-agents (git-droid, docs-droid)
• No manual configuration required!

For testing or development, see Plugin Installation Guide.

Option 2: Manual MCP Setup (Alternative)

If you prefer manual control or are testing local changes:

1. Clone and build the devsolo repository:

   git clone https://github.com/slamb2k/devsolo.git
   cd devsolo
   npm install
   npm run build
   

2. Configure Claude Code to load the MCP server: Add to your Claude Code MCP configuration file:

   {
     "mcpServers": {
       "devsolo": {
         "command": "node",
         "args": ["/path/to/devsolo/dist/mcp/devsolo-mcp-server.js"]
       }
     }
   }
   

3. Restart Claude Code to load the MCP tools

4. Initialize in your project using natural language:

   "Initialize devsolo in this project"
   

   Claude will invoke the devsolo_init tool automatically.

For detailed installation instructions, see the Installation Guide.

Quick Start

New to devsolo? Follow these steps to get started with Claude Code.

Two Ways to Use devsolo

devsolo provides both native slash commands and direct MCP tool calls for maximum flexibility:

Option 1: Slash Commands (Recommended) 🎯

/devsolo:init       - Initialize devsolo
/devsolo:launch     - Start a new feature
/devsolo:commit     - Commit changes
/devsolo:ship       - Ship your changes (full workflow)
/devsolo:status     - Check current status

Option 2: Natural Language (Direct MCP Tool Calls)

"Use devsolo_init to initialize devsolo in this project"
"Use devsolo_launch to start a new feature for authentication"
"Use devsolo_ship to commit, push, create PR, and merge"

Slash commands provide better integration, auto-completion, and coordinated workflows via specialized sub-agents (git-droid, docs-droid)!

---

1. Initialize devsolo in your project

Using slash command:

/devsolo:init

Or using natural language:

Use devsolo_init to initialize devsolo in this project

This creates a .devsolo directory with configuration and session storage.

2. (Optional) Set up GitHub authentication

# Option A: GitHub CLI (easiest)
gh auth login

# Option B: Personal access token
export GITHUB_TOKEN=ghp_your_token_here

3. Start a new feature workflow

Using slash command:

/devsolo:launch

Or using natural language:

Use devsolo_launch to start a new feature for [your feature description]

This creates a new feature branch and starts tracking your workflow.

4. Make your changes

Work on your feature as normal. devsolo tracks your session automatically.

Check status:

/devsolo:status

5. Ship your changes (One Command! 🚀)

Using slash command:

/devsolo:ship

Or using natural language:

Use devsolo_ship to commit, push, create PR, and merge this feature