claude-code-boilerplate

# Claude Code Sandbox with Task Master AI MCP

This project creates a powerful three-agent development environment that combines **Claude Code**, **Cursor**, and **Task Master AI** to work together on complex software development tasks.

## Overview

This dockerized development environment orchestrates three AI agents working in harmony:

- **Claude Code** - Provides advanced code generation and analysis capabilities
- **Cursor IDE** - Offers intelligent code editing and development features
- **Task Master AI** - Manages and coordinates tasks across the development workflow

Both 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 Cursor's YOLO mode (using `--dangerously-skip-permissions`) can be risky in unrestricted environments.

**Key Benefits:**

- **Long-running execution** - Designed to run uninterrupted for extended periods
- **Feature completion** - Capable of finishing entire application features autonomously
- **Safe isolation** - Docker containment prevents system-level risks from aggressive AI permissions
- **Multi-agent coordination** - Three specialized agents working together for optimal results

The project automatically sets up Model Context Protocol (MCP) connections between all agents when the container starts, creating a seamless collaborative development environment.

## Prerequisites

Before using this devcontainer, make sure you have:

1. **Docker Desktop** installed and running on your system

   - [Download Docker Desktop](https://www.docker.com/products/docker-desktop/)

2. **Cursor IDE** with the Dev Containers extension

   - Install the "Dev Containers" extension in Cursor
   - You can find it in the extensions marketplace by searching for "Dev Containers"

3. **API Keys** for the MCP connection:
   - **Anthropic API Key** for Cursor
   - **Cursor API Key** for enhanced functionality

## Setup I