macOS (recommended)

1<div align="center">
2  <img src="./docs/images/container-use.png" align="center" alt="Container use: Development environments for coding agents." />
3  <h1 align="center">container-use</h2>
4  <p align="center">Containerized environments for coding agents. (📦🤖) (📦🤖) (📦🤖)</p>
5  <p align="center">
6    <img src="https://img.shields.io/badge/stability-experimental-orange.svg" alt="Experimental" />
7    <a href="https://opensource.org/licenses/Apache-2.0">
8      <img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg">
9    </a>
10    <a href="https://container-use.com/discord">
11      <img src="https://img.shields.io/discord/707636530424053791?logo=discord&logoColor=white&label=Discord&color=7289DA" alt="Discord">
12    </a>
13    <a href="https://github.com/clinebot/awesome-claude-code">
14      <img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome Claude Code">
15    </a>
16  </p>
17</div>
18 
19**Container Use** lets coding agents do their work in parallel environments without getting in your way. Go from babysitting one agent at a time to enabling multiple agents to work safely and independently with your preferred stack. See the [full documentation](https://container-use.com).
20 
21<p align='center'>
22    <img src='./docs/images/demo.gif' width='700' alt='container-use demo'>
23</p>
24 
25It's an open-source MCP server that works as a CLI tool with Claude Code, Cursor, and other MCP-compatible agents. Powered by [Dagger](https://dagger.io).
26 
27* 📦 **Isolated Environments**: Each agent gets a fresh container in its own git branch - run multiple agents without conflicts, experiment safely, discard failures instantly.
28* 👀 **Real-time Visibility**: See complete command history and logs of what agents actually did, not just what they claim.
29* 🚁 **Direct Intervention**: Drop into any agent's terminal to see their state and take control when they get stuck.
30* 🎮 **Environment Control**: Standard git workflow - just `git checkout <branch_name>` to review any agent's work.
31* 🌎 **Universal Compatibility**: Works with any agent, model, or infrastructure - no vendor lock-in.
32 
33---
34 
35🦺 This project is in early development and actively evolving. Submit issues and/or reach out to us on [Discord](https://container-use.com/discord) in the #container-use channel.
36 
37---
38 
39## Quick Start
40 
41### Install
42 
43```sh
44# macOS (recommended)
45brew install dagger/tap/container-use
46 
47# All platforms
48curl -fsSL https://raw.githubusercontent.com/dagger/container-use/main/install.sh | bash
49```
50 
51### Setup with Your Agent
52 
53Container Use works with any MCP-compatible agent. The setup is always the same: **add `container-use stdio` as an MCP server**.
54 
55**👉 [Complete setup guide for all agents (Cursor, Goose, VSCode, etc.)](https://container-use.com/quickstart)**
56 
57**Example with Claude Code:**
58 
59```sh
60# Add Container Use MCP server
61cd /path/to/repository
62claude mcp add container-use -- container-use stdio
63 
64# Add agent rules (optional)
65curl https://raw.githubusercontent.com/dagger/container-use/main/rules/agent.md >> CLAUDE.md
66```
67 
68<details>
69<summary>💡 Command Shortcut</summary>
70 
71The `container-use` command is also available as `cu` for convenience. Both commands work identically:
72- `container-use stdio` (used in documentation)
73- `cu stdio` (shortcut)
74 
75</details>
76 
77### Try It
78 
79Ask your agent to create something:
80> Create a hello world app in python using flask
81 
82Your agent will work in an isolated environment and give you URLs to view the app and explore the code!