📦 Installation

Prerequisites

• Claude Desktop app
• macOS, Linux, or Windows

Install from Bundle

Download the latest release:

• Download universal-dev-workspace-6.0.1-FINAL.mcpb from releases

Install via Claude Desktop:

1. Open Claude Desktop → Settings → Extensions
2. Click "Install Extension"
3. Select the downloaded .mcpb file
4. Restart Claude Desktop

Install via Terminal (macOS):

cp universal-dev-workspace-6.0.1-FINAL.mcpb \
   ~/Library/Application\ Support/Claude/extensions/
# Restart Claude Desktop

Install as Claude Code Plugin (Recommended)

Quick Install:

# Add marketplace
/plugin marketplace add anthonybir/universal-dev-workspace

# Install plugin
/plugin install universal-dev-workspace@universal-dev-workspace-marketplace

Manual Install from GitHub:

1. Clone repository:

   git clone https://github.com/anthonybir/universal-dev-workspace.git
   cd universal-dev-workspace
   

2. Install via Claude Code:

   /plugin marketplace add /path/to/universal-dev-workspace
   /plugin install universal-dev-workspace@universal-dev-workspace-marketplace
   

Features Installed:

• ✅ 60+ MCP tools (auto-configured via npx)
• ✅ 5 Slash commands: /workspace-init, /repl, /git-flow, /github-file, /dev-env
• ✅ 5 Specialized agents for workspace, REPL, git, GitHub, and DevOps management
• ✅ Comprehensive skill documentation

Slash Commands:

• /workspace-init [name] [template] - Initialize new workspace
• /repl [language] [session] - Start interactive REPL
• /git-flow [type] - Execute git workflows
• /github-file [op] [repo] [path] - GitHub remote operations
• /dev-env [action] [service] - Manage dev servers/Docker

Configuration: For GitHub operations, set environment variable:

export GITHUB_TOKEN="your_github_personal_access_token"

Verify Installation

• Extension shows "Connected" status
• Version displays as 6.0.1
• All 60 tools are available

🚀 Quick Start

Example 1: Python REPL Session

// Start Python REPL
start_process({
  command: "python3 -i",
  session: "python-session",
  timeout_ms: 2000
})
// ✅ Detects prompt in ~200ms
// ✅ Shows: "🔄 Detected prompt: '>>>'"

// Execute code
interact_with_process({
  session: "python-session",
  input: "import pandas as pd\ndf = pd.read_csv('data.csv')"
})

// Get results
interact_with_process({
  session: "python-session",
  input: "print(df.describe())"
})

// Cleanup
force_terminate({ session: "python-session" })

Example 2: Shell Command Execution

start_process({
  command: "npm test",
  session: "test-run",
  timeout_ms: 30000
})

🔧 All Fixes in v6.0.1

Issue #1: Prompt Detection (✅ FIXED)

• Problem: Regex never matched due to [STDERR] prefix pollution
• Solution: 7-part fix separating raw buffers from display formatting
• Result: 15x faster REPL startup (200ms vs 3000ms)

Issue #2: Bundle Structure (✅ FIXED)

• Problem: Files at root instead of server/ subdirectory
• Solution: Corrected build process to match manifest entry_point
• Result: Server launches successfully

Issue #3: macOS PATH Error (✅ FIXED)

• Problem: spawn bash ENOENT on macOS
• Solution: Absolute paths and full PATH in environment
• Result: Reliable shell spawning on all platforms

Issue #4: Race Condition (✅ FIXED)

• Problem: interact_with_process returned empty output
• Solution: 50ms delay after prompt detection for async events
• Result: Reliable output capture in all scenarios

See V6.0.1-ALL-FIXES-SUMMARY.md for complete technical details.

📊 Performance Comparison

🛠️ Development

Build from Source

Requirements:

• Node.js 18+
• npm or yarn

Clone and build:

git clone https://github.com/anthonybir/universal-dev-workspace.git
cd universal-dev-workspace
cd build-v6.0.1-correct/server
npm install
cd ../..
# Bundle is in build-v6.0.1-correct/

Project Structure

universal-dev-workspace/
├── build-v6.0.1-correct/
│   ├── manifest.json          # MCP extension metadata
│   └── server/
│       ├── index.js           # Main server entry point
│       └── node_modules/      # Production dependencies
├── package.json               # Package metadata
└── V6.0.1-ALL-FIXES-SUMMARY.md  # Technical documentation

📝 License

MIT License - see LICENSE file for details

🤝 Contributing

Contributions welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Submit a pull request with detailed description

🐛 Issues

Report bugs and feature requests on the GitHub Issues page.

📚 Documentation

• API Reference: docs/API.md - Complete guide to all 60+ tools
• Technical Details: V6.0.1-ALL-FIXES-SUMMARY.md
• Changelog: CHANGELOG.md - Version history
• MCP Protocol: Model Context Protocol
• Claude Desktop: Anthropic Claude

✨ Credits

Built with:

• @modelcontextprotocol/sdk - MCP protocol implementation
• @octokit/rest - GitHub API client
• archiver - Archive creation
• js-yaml - YAML processing

Version: 6.0.1 Status: ✅ Production Ready Last Updated: October 18, 2025