Mission Control - AI Workflow Orchestration for VS Code

A revolutionary VS Code extension that transforms AI assistant interactions into visual, orchestrated workflows. Think of it as mission control for your Claude Code and Gemini CLI sessions.

🚀 Features

Visual Workflow Builder

• Node-Based Editor: Drag-and-drop interface for creating AI workflows
• Real-Time Execution: Watch your AI assistants work in synchronized terminals
• Orange Glow Highlighting: Visual feedback for active terminals and processes
• Dependency Chaining: Connect nodes with "run on completion" logic

Intelligent Terminal Management

• Auto-Detection: Automatically detects and names Claude Code sessions
• Smart Naming: Extracts conversation topics for meaningful terminal names
• Process Monitoring: Real-time status tracking and completion detection
• Terminal Highlighting: One-click navigation to related terminals

Advanced AI Integration

• Claude Code Integration: Seamless integration with Claude Code CLI
• Gemini Documentation Context: Hierarchical GEMINI.md file loading
• Context-Aware Execution: Pass file context and project information to AI
• Multi-AI Workflows: Chain Claude and Gemini for verification workflows

Workflow Orchestration

• Save/Load Workflows: Persist complex workflows as JSON files
• Template Library: Pre-built workflows for common development tasks
• Auto-Execution: Trigger dependent nodes on completion
• Human-in-the-Loop: Manual approval points in automated workflows

📦 Installation

Prerequisites

• VS Code 1.74.0 or higher
• Claude Code CLI installed and configured
• Gemini CLI (optional, for Gemini features)

Install from VSIX

1. Download the latest .vsix file from releases
2. Open VS Code
3. Run Extensions: Install from VSIX... from the Command Palette
4. Select the downloaded .vsix file

Build from Source

git clone https://github.com/yourusername/mission-control
cd mission-control
npm install
npm run compile
npm run package

🎯 Quick Start

1. Open Mission Control: Click the rocket icon (🚀) in the Activity Bar
2. Create Your First Workflow:
   • Click "+ Claude" to add a Claude Code node
   • Double-click the node to execute it
   • Watch the orange glow as it runs!
3. Add Connections: Create multiple nodes and chain them together
4. Save Your Workflow: Use the save button to persist your workflow

🔧 Configuration

Open VS Code Settings and search for "Mission Control":

{
  "mission-control.autoDetectClaude": true,
  "mission-control.terminalNamingPattern": "Claude: {topic}",
  "mission-control.geminiContextPath": "GEMINI.md",
  "mission-control.enableOrangeGlow": true
}

📝 GEMINI.md Context System

Mission Control supports hierarchical context loading for Gemini:

Context File Hierarchy

1. Global: ~/.gemini/GEMINI.md - Personal AI guidelines
2. Project: ./GEMINI.md - Project-specific documentation
3. Component: ./path/to/component/GEMINI.md - Module-specific context

Example GEMINI.md

# Project Context

## Architecture
This is a TypeScript VS Code extension using the Extension API.

## Coding Standards
- Use async/await for asynchronous operations
- Follow VS Code webview security guidelines
- Implement proper error handling

## Key Dependencies
- vscode: VS Code Extension API
- uuid: Unique identifier generation

🎨 Node Types

Claude Code Node

• Executes Claude Code CLI commands
• Supports context injection from selected code
• Auto-detects conversation topics for naming

Gemini Node

• Runs Gemini CLI with project context
• Loads hierarchical GEMINI.md files
• Perfect for documentation-based verification

Terminal Node

• Executes arbitrary shell commands
• Useful for build steps, tests, deployments
• Integrates with AI workflows

🔗 Workflow Patterns

Generator → Verifier

[Claude: Generate Code] → [Gemini: Verify Against Docs]

Development Pipeline

[Claude: Write Feature] → [Terminal: Run Tests] → [Gemini: Review Code]

Documentation Workflow

[Claude: Analyze Code] → [Claude: Write Docs] → [Terminal: Build Docs]

🎮 Commands

Command	Description	Shortcut
mission-control.newWorkflow	Create new workflow	-
mission-control.saveWorkflow	Save current workflow	-
mission-control.loadWorkflow	Load saved workflow	-
mission-control.askClaude	Create Claude node from selection	Right-click menu
mission-control.refreshCanvas	Refresh workflow canvas	-

🔄 Workflow File Format

Workflows are saved as JSON files in .mission-control/ directory:

{
  "id": "uuid",
  "name": "My Workflow",
  "nodes": [
    {
      "id": "node-1",
      "type": "claude",
      "position": { "x": 100, "y": 100 },
      "data": {
        "label": "Code Review",
        "prompt": "Review this code for best practices",
        "status": "idle"
      }
    }
  ],
  "edges": [
    {
      "id": "edge-1",
      "source": "node-1",
      "target": "node-2",
      "data": { "triggerType": "completion" }
    }
  ]
}

🐛 Troubleshooting

Extension Not Loading

• Check VS Code version (requires 1.74.0+)
• Verify extension is enabled in Extensions panel
• Check Developer Console for errors (Help > Toggle Developer Tools)

Claude Code Not Detected

• Ensure Claude Code CLI is installed and in PATH
• Check terminal naming pattern in settings
• Verify mission-control.autoDetectClaude is enabled

Gemini Context Not Loading

• Check GEMINI.md file exists and has content
• Verify file permissions are readable
• Use Command Palette: "Mission Control: Show Context Summary"

🧩 Extension API

For advanced users wanting to integrate with Mission Control:

// Get the extension
const missionControl = vscode.extensions.getExtension('mission-control');

// Access the sidebar provider
const sidebarProvider = missionControl.exports.sidebarProvider;

// Create a new Claude node programmatically
sidebarProvider.createClaudeNode('Analyze this function', '/path/to/file.ts');

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Inspired by the visual workflow tools like n8n and Node-RED
• Built on the powerful VS Code Extension API
• Designed for the Claude Code and Gemini CLI communities

🔮 Roadmap

• React Flow integration for advanced node editing
• Custom node types via extension API
• Workflow templates marketplace
• Real-time collaboration on workflows
• Integration with GitHub Actions
• Voice control for workflow execution
• AI-powered workflow optimization

---

Mission Control - Where AI workflows take flight 🚀