{"id":31038828,"url":"https://github.com/aemal/vibebox","last_synced_at":"2025-09-14T07:03:13.875Z","repository":{"id":313453434,"uuid":"1051486319","full_name":"aemal/vibebox","owner":"aemal","description":"VibeBox is a powerful three-agent development environment that combines Claude Code, Cursor, and Task Master AI to work together on complex software development tasks.","archived":false,"fork":false,"pushed_at":"2025-09-06T05:24:59.000Z","size":2104,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-06T07:14:44.526Z","etag":null,"topics":["claudecode","cursor","multi-agent","taskmaster","vibecoding"],"latest_commit_sha":null,"homepage":"https://aemalsayer.com","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aemal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-06T05:05:50.000Z","updated_at":"2025-09-06T05:25:03.000Z","dependencies_parsed_at":"2025-09-06T07:14:46.216Z","dependency_job_id":"13c2d466-ac4e-4fa2-9338-c674c593fd68","html_url":"https://github.com/aemal/vibebox","commit_stats":null,"previous_names":["aemal/vibebox"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/aemal/vibebox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aemal%2Fvibebox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aemal%2Fvibebox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aemal%2Fvibebox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aemal%2Fvibebox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aemal","download_url":"https://codeload.github.com/aemal/vibebox/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aemal%2Fvibebox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275071533,"owners_count":25400402,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-14T02:00:10.474Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claudecode","cursor","multi-agent","taskmaster","vibecoding"],"created_at":"2025-09-14T07:02:37.518Z","updated_at":"2025-09-14T07:03:13.860Z","avatar_url":"https://github.com/aemal.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VibeBox\n\nVibeBox is a powerful three-agent development environment that combines **Claude Code**, **Cursor**, and **Task Master AI** to work together on complex software development tasks.\n\n## Overview\n\nThis dockerized development environment orchestrates three AI agents working in harmony:\n\n- **Claude Code** - Provides advanced code generation and analysis capabilities\n- **Cursor IDE** - Offers intelligent code editing and development features\n- **Task Master AI** - Manages and coordinates tasks across the development workflow\n\nBoth Claude Code and Cursor can produce code simultaneously, while Task Master AI handles task management and coordination between the agents. This setup is specifically dockerized for safety, as Claude's YOLO mode (using `--dangerously-skip-permissions`) can be risky in unrestricted environments.\n\n![abc](images/00-vibebox.jpeg)\n\n\u003e Note: Soon I will add Gemini CLI in VibeBox\n\n**Key Benefits:**\n\n- **Long-running execution** - Designed to run uninterrupted for extended periods\n- **Feature completion** - Capable of finishing entire application features autonomously\n- **Safe isolation** - Docker containment prevents system-level risks from aggressive AI permissions\n- **Multi-agent coordination** - Three specialized agents working together for optimal results\n\nThe project automatically sets up Model Context Protocol (MCP) connections between all agents when the container starts, creating a seamless collaborative development environment.\n\n## Prerequisites\n\nBefore using this devcontainer, make sure you have:\n\n1. **Docker Desktop** installed and running on your system\n\n   - [Download Docker Desktop](https://www.docker.com/products/docker-desktop/)\n\n2. **Cursor IDE** with the Dev Containers extension\n\n   - Install the \"Dev Containers\" extension in Cursor\n   - You can find it in the extensions marketplace by searching for \"Dev Containers\"\n\n3. **API Keys** for the MCP connection:\n   - **Anthropic API Key** for Claude\n   - **Perplexity API Key** for enhanced functionality\n\n## Setup Instructions\n\nFollow these simple steps to get your development environment up and running:\n\n### Step 1: Clone the Project\n\n```bash\ngit clone https://github.com/aemal/claude-code-boilerplate\ncd vibebox\n```\n\n### Step 2: Prepare Your Environment\n\n1. **Run Docker Desktop** - Make sure Docker Desktop is installed and running on your system\n2. **Install Dev Containers Extension** - Ensure you have the \"Dev Containers\" extension installed in Cursor\n3. **Open the project** in Cursor:\n\n```bash\ncursor .\n```\n\n\u003e **Note**: You might not be able to open Cursor by typing `cursor .`. If this doesn't work, search ChatGPT for \"how to set up cursor command line\" to find instructions for your operating system.\n\n![Docker Desktop \u0026 Dev Containers running](images/01-dev-container-and-docker.png)\n\n### Step 3: Configure API Keys\n\nOpen the `.env` file and provide your API keys:\n\n```env\nANTHROPIC_API_KEY=your_anthropic_key_here\nPERPLEXITY_API_KEY=your_perplexity_key_here\n```\n\n![.env file configuration](images/02-env-variables.png)\n\n### Step 4: Open in Dev Container\n\nClick on **\"Reopen in Container\"** when prompted, or manually trigger it:\n\n1. Press `Cmd+Shift+P` (macOS) or `Ctrl+Shift+P` (Windows/Linux)\n2. Select **\"Dev Containers: Open Folder in Container\"**\n\n### Step 5: Wait for the Magic! ✨\n\nThe system will automatically:\n\n- Create a Docker container\n- Install Claude Code\n- Install Task Master AI\n- Set up the MCP server\n\nYou should see the Docker container running in the Docker Desktop app.\n\n---\n\n## Detailed Setup Information\n\n## What Happens During Container Startup\n\nWhen the devcontainer starts, it automatically:\n\n1. **Builds the Docker environment** with Node.js, development tools, and dependencies\n2. **Sets up firewall rules** for secure network access\n3. **Loads environment variables** from your `.env` file\n4. **Installs Claude CLI and task-master-ai** packages\n5. **Configures the MCP connection** between Claude and task-master-ai\n6. **Verifies the connection** to ensure everything is working properly\n\n## Viewing Setup Logs\n\nDuring container initialization, you can monitor the setup progress in **Cursor's Terminal/Output panel**:\n\n1. **During Container Build**: Look for the \"Dev Containers\" output channel in Cursor's Terminal panel\n2. **Container Creation Logs**: The initialization logs appear in the terminal as the container starts\n3. **Post-Creation**: You can also view logs by running the setup script manually\n\nYou'll see output similar to this during startup:\n\n```\nInitializing environment...\nLoading environment variables from .env file...\nSetting up firewall...\nSetting up MCP connection...\nAdding task-master-ai MCP connection...\nVerifying MCP connection status...\n✅ MCP connection verified successfully!\n🎉 MCP setup complete! You can now use task-master-ai through Claude MCP.\n```\n\n**To view logs after container is running:**\n\n- Check current MCP status: `claude mcp list`\n- Re-run setup manually: `sudo /usr/local/bin/setup-mcp.sh`\n- View initialization logs: Check Cursor's Terminal → Output → Dev Containers\n\n## Using the MCP Connection\n\nOnce the container is running and the MCP connection is established, you can:\n\n### Check Connection Status\n\n```bash\nclaude mcp list\n```\n\nThis should show `task-master-ai` with a status of `connected`.\n\n### Use Task Master AI\n\nThe task-master-ai tool is now available through Claude's MCP interface and can help with:\n\n- Project management and task organization\n- Code analysis and suggestions\n- Development workflow automation\n- Research and information gathering (via Perplexity integration)\n\n## File Structure\n\n```\n.\n├── .devcontainer/\n│   ├── devcontainer.json       # Dev container configuration\n│   ├── Dockerfile              # Container image definition\n│   ├── init-environment.sh     # Environment initialization script\n│   ├── setup-mcp.sh           # MCP connection setup script\n│   └── init-firewall.sh       # Network security setup\n├── .env.example               # Template for environment variables\n├── .env                       # Your actual API keys (don't commit!)\n├── .gitignore                # Git ignore rules\n└── README.md                 # This file\n```\n\n## Troubleshooting\n\n### Connection Failed\n\nIf the MCP connection fails during setup:\n\n1. **Check your API keys** in the `.env` file\n2. **Verify internet connectivity** within the container\n3. **Manually retry the setup**:\n   ```bash\n   sudo /usr/local/bin/setup-mcp.sh\n   ```\n\n### Environment Variables Not Loaded\n\nIf environment variables aren't being loaded:\n\n1. **Ensure the `.env` file exists** in the project root\n2. **Check the file format** - no spaces around the `=` sign\n3. **Rebuild the container**:\n   - Press `Cmd+Shift+P` → \"Dev Containers: Rebuild Container\"\n\n### Network Issues\n\nIf you encounter network connectivity problems:\n\n1. **Check Docker Desktop** is running\n2. **Verify firewall settings** on your host system\n3. **Try restarting** Docker Desktop\n\n### Manual MCP Management\n\nYou can manually manage MCP connections:\n\n```bash\n# List all MCP connections\nclaude mcp list\n\n# Remove a connection\nclaude mcp remove task-master-ai\n\n# Re-add the connection\nsudo /usr/local/bin/setup-mcp.sh\n```\n\n## Development Features\n\nThis devcontainer includes:\n\n- **Node.js 22** runtime environment\n- **Git** with delta for better diffs\n- **ESLint and Prettier** for code quality\n- **Zsh with Powerlevel10k** theme\n- **Network security** with firewall rules\n- **Persistent command history**\n- **Port forwarding** for web development (port 3000)\n\n## Security Notes\n\n- The container runs with restricted network access via firewall rules\n- Only whitelisted domains (GitHub, NPM, Anthropic, etc.) are accessible\n- API keys are kept in environment variables and not logged\n- The `.env` file is automatically excluded from version control\n\n## Support\n\nIf you encounter issues:\n\n1. Check the container logs during startup\n2. Verify your API keys are valid and have the necessary permissions\n3. Ensure Docker Desktop has sufficient resources allocated\n4. Try rebuilding the container if problems persist\n\n## Credits\n\nThis repository was created by **[Aemal Sayer](https://aemalsayer.com)**, an experienced software engineer with 23 years of software development experience, including 17 years as a full-stack developer and 7+ years in AI/ML. For the past 2.5 years, he has been specializing in building AI agents.\n\n**Connect with Aemal:**\n\n- 🌐 Website: [aemalsayer.com](https://aemalsayer.com)\n- 💼 LinkedIn: [linkedin.com/in/aemal](https://linkedin.com/in/aemal)\n- 📺 YouTube: [youtube.com/@agentgeeks](https://youtube.com/@agentgeeks)\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n**Note**: This setup is designed for development and testing purposes. For production use, consider additional security measures and proper secrets management.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faemal%2Fvibebox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faemal%2Fvibebox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faemal%2Fvibebox/lists"}