dagger · shykes · Jul 7, 2025
diff --git a/docs/amazon-q.mdx b/docs/amazon-q.mdx
@@ -0,0 +1,84 @@
+---
+title: Amazon Q Developer
+description: "Setup guide for Amazon Q Developer with Container Use"
+icon: robot
+---
+
+## Add MCP Configuration
+
+Add this configuration to `~/.aws/amazonq/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "container-use": {
+      "command": "cu",
+      "args": ["stdio"],
+      "env": {},
+      "timeout": 60000
+    }
+  }
+}
+```
+
+## Add Agent Rules
+
+Save agent instructions to your project root:
+
+```sh
+mkdir -p ./.amazonq/rules && curl https://raw.githubusercontent.com/dagger/container-use/main/rules/agent.md > .amazonq/rules/container-use.md
+```
+
+## Trust Only Container Use Tools (Optional)
+
+```sh
+q chat --trust-tools=container_use___environment_checkpoint,container_use___environment_file_delete,container_use___environment_file_list,container_use___environment_file_read,container_use___environment_file_write,container_use___environment_open,container_use___environment_run_cmd,container_use___environment_update
+```
+
+<Card title="Video Tutorial" icon="youtube" href="https://youtu.be/C2g3vdbffOI">
+  Watch the Amazon Q Developer setup walkthrough
+</Card>
+
+## Verification
+
+After setting up Amazon Q Developer, verify Container Use is working:
+
+1. **Check MCP Connection**: Amazon Q should recognize Container Use tools
+2. **Test Environment Creation**: Ask Amazon Q to create a new environment
+3. **Verify Isolation**: Multiple environments should work independently
+
+## Troubleshooting
+
+<AccordionGroup>
+  <Accordion title="Amazon Q doesn't recognize Container Use">
+    - Verify the `cu` command is in your PATH: `which cu`
+    - Check MCP configuration syntax
+    - Restart Amazon Q after configuration changes
+  </Accordion>
+
+  <Accordion title="Permission errors">
+    - Ensure Docker is running and accessible
+    - Check file permissions for configuration files
+    - Verify `cu stdio` command works: `echo '{}' | cu stdio`
+  </Accordion>
+
+  <Accordion title="Tools not appearing">
+    - Check your Amazon Q MCP server logs
+    - Verify Container Use tools are enabled in settings
+  </Accordion>
+</AccordionGroup>
+
+## Next Steps
+
+<CardGroup cols={2}>
+  <Card title="Back to Quickstart" icon="rocket" href="/quickstart">
+    Return to the quickstart guide to create your first environment
+  </Card>
+  <Card
+    title="Join Community"
+    icon="discord"
+    href="https://discord.gg/YXbtwRQv"
+  >
+    Get help and share experiences in #container-use
+  </Card>
+</CardGroup>
diff --git a/docs/claude-code.mdx b/docs/claude-code.mdx
@@ -0,0 +1,83 @@
+---
+title: Claude Code
+description: "Setup guide for Claude Code with Container Use"
+icon: robot
+---
+
+## Install Claude Code
+
+```sh
+npm install -g @anthropic-ai/claude-code
+```
+
+## Add MCP Configuration
+
+```sh
+cd /path/to/repository
+claude mcp add container-use -- <full path to cu command> stdio
+```
+
+## Add Agent Rules (Optional)
+
+Save the CLAUDE.md file at the root of your repository:
+
+```sh
+curl https://raw.githubusercontent.com/dagger/container-use/main/rules/agent.md >> CLAUDE.md
+```
+
+## Trust Only Container Use Tools (Optional)
+
+For maximum security, restrict Claude Code to only use Container Use tools:
+
+```sh
+claude --allowedTools mcp__container-use__environment_checkpoint,mcp__container-use__environment_create,mcp__container-use__environment_add_service,mcp__container-use__environment_file_delete,mcp__container-use__environment_file_list,mcp__container-use__environment_file_read,mcp__container-use__environment_file_write,mcp__container-use__environment_open,mcp__container-use__environment_run_cmd,mcp__container-use__environment_update
+```
+
+<Info>
+  Learn more: [Claude Code MCP
+  Documentation](https://docs.anthropic.com/en/docs/claude-code/tutorials#set-up-model-context-protocol-mcp)
+</Info>
+
+## Verification
+
+After setting up Claude Code, verify Container Use is working:
+
+1. **Check MCP Connection**: Claude Code should recognize Container Use tools
+2. **Test Environment Creation**: Ask Claude Code to create a new environment
+3. **Verify Isolation**: Multiple environments should work independently
+
+## Troubleshooting
+
+<AccordionGroup>
+  <Accordion title="Claude Code doesn't recognize Container Use">
+    - Verify the `cu` command is in your PATH: `which cu`
+    - Check MCP configuration syntax
+    - Restart Claude Code after configuration changes
+  </Accordion>
+
+  <Accordion title="Permission errors">
+    - Ensure Docker is running and accessible
+    - Check file permissions for configuration files
+    - Verify `cu stdio` command works: `echo '{}' | cu stdio`
+  </Accordion>
+
+  <Accordion title="Tools not appearing">
+    - Check your Claude Code MCP server logs
+    - Verify Container Use tools are enabled in settings
+  </Accordion>
+</AccordionGroup>
+
+## Next Steps
+
+<CardGroup cols={2}>
+  <Card title="Back to Quickstart" icon="rocket" href="/quickstart">
+    Return to the quickstart guide to create your first environment
+  </Card>
+  <Card
+    title="Join Community"
+    icon="discord"
+    href="https://discord.gg/YXbtwRQv"
+  >
+    Get help and share experiences in #container-use
+  </Card>
+</CardGroup>
diff --git a/docs/cursor.mdx b/docs/cursor.mdx
@@ -0,0 +1,68 @@
+---
+title: Cursor
+description: "Setup guide for Cursor with Container Use"
+icon: robot
+---
+
+## Install MCP Server
+
+Use the one-click deeplink to install (requires Cursor and Container Use already installed):
+
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=container-use&config=eyJjb21tYW5kIjoiY3Ugc3RkaW8ifQ%3D%3D)
+
+## Add Agent Rules
+
+Add the rules file to your project or home directory:
+
+```sh
+curl --create-dirs -o .cursor/rules/container-use.mdc https://raw.githubusercontent.com/dagger/container-use/main/rules/cursor.mdc
+```
+
+<Info>
+  Learn more: [Cursor MCP
+  Documentation](https://docs.cursor.com/context/model-context-protocol)
+</Info>
+
+## Verification
+
+After setting up Cursor, verify Container Use is working:
+
+1. **Check MCP Connection**: Cursor should recognize Container Use tools
+2. **Test Environment Creation**: Ask Cursor to create a new environment
+3. **Verify Isolation**: Multiple environments should work independently
+
+## Troubleshooting
+
+<AccordionGroup>
+  <Accordion title="Cursor doesn't recognize Container Use">
+    - Verify the `cu` command is in your PATH: `which cu`
+    - Check MCP configuration syntax
+    - Restart Cursor after configuration changes
+  </Accordion>
+
+  <Accordion title="Permission errors">
+    - Ensure Docker is running and accessible
+    - Check file permissions for configuration files
+    - Verify `cu stdio` command works: `echo '{}' | cu stdio`
+  </Accordion>
+
+  <Accordion title="Tools not appearing">
+    - Check your Cursor MCP server logs
+    - Verify Container Use tools are enabled in settings
+  </Accordion>
+</AccordionGroup>
+
+## Next Steps
+
+<CardGroup cols={2}>
+  <Card title="Back to Quickstart" icon="rocket" href="/quickstart">
+    Return to the quickstart guide to create your first environment
+  </Card>
+  <Card
+    title="Join Community"
+    icon="discord"
+    href="https://discord.gg/YXbtwRQv"
+  >
+    Get help and share experiences in #container-use
+  </Card>
+</CardGroup>
diff --git a/docs/docs.json b/docs/docs.json
@@ -29,7 +29,12 @@
           {
             "group": "Integrations",
             "pages": [
-              "agent-integrations"
+              "claude-code",
+              "cursor",
+              "amazon-q",
+              "vscode",
+              "zed",
+              "other-agents"
             ]
           }
         ]