container-use

MCP server to add container superpowers to your AI agent

Installing

go build ./cmd/container-use

Make sure to put container-use in your $PATH

Agent Integration

Enabling container-use requires 2 steps:

1. Adding an MCP configuration for container-use
2. (Optional) Adding a rule so the agent uses containarized environments.

Claude Code

# Add the container-use MCP
npx @anthropic-ai/claude-code mcp add container-use -- <path to container-use> stdio

# Save the CLAUDE.md file at the root of the repository. Alternatively, merge the instructions into your own CLAUDE.md.
curl -o CLAUDE.md https://raw.githubusercontent.com/aluzzardi/container-use/main/rules/agent.md

Goose

Add this to ~/.config/goose/config.yaml:

extensions:
  container-use:
    name: container-use
    type: stdio
    enabled: true
    cmd: container-use
    args:
    - stdio
    envs: []

Cursor

curl --create-dirs -o .cursor/rules/container-use.mdc https://raw.githubusercontent.com/aluzzardi/container-use/main/rules/cursor.mdc

VSCode / GitHub Copilot

curl --create-dirs -o .github/copilot-instructions.md https://raw.githubusercontent.com/aluzzardi/container-use/main/rules/agent.md

Examples

Run with goose:

goose run -i ./examples/security.md -s

Watching your agents work

Your agents will automatically commit to a container-use remote on your local filesystem. You can watch the progress of your agents in real time by running:

container-use watch