container-use

by aluzzardi

3.9k 727 downloads Not rated yet Apache-2.0

About

Development environments for coding agents. Enable multiple agents to work safely and independently with your preferred stack.

Details

License
Apache-2.0

Explore

- Isolated environments: each agent gets a fresh container and its own git branch
- Real-time visibility: see complete command history and logs
- Direct intervention: drop into any agentโ€™s terminal to take control
- Environment control: standard git workflow to review work
- Universal compatibility: works with any agent, model, or infrastructure
- Open-source and self-hostable


Container Use works with any MCP-compatible agent. The setup is always the same: add container-use stdio as an MCP server.

๐Ÿ‘‰ Complete setup guide for all agents (Cursor, Goose, VSCode, etc.)

Example with Claude Code:

sh

<div align="center">
Container use: Development environments for coding agents.
<h1 align="center">container-use</h2>
<p align="center">Containerized environments for coding agents. (๐Ÿ“ฆ๐Ÿค–) (๐Ÿ“ฆ๐Ÿค–) (๐Ÿ“ฆ๐Ÿค–)</p>
<p align="center">
Experimental
<a href="https://opensource.org/licenses/Apache-2.0">

</a>
<a href="https://container-use.com/discord">
Discord
</a>
<a href="https://github.com/clinebot/awesome-claude-code">
Mentioned in Awesome Claude Code
</a>
</p>
</div>

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.

<p align='center'>
container-use demo
</p>

It's an open-source MCP server that works as a CLI tool with Claude Code, Cursor, and other MCP-compatible agents. Powered by Dagger.

๐Ÿ“ฆ Isolated Environments: Each agent gets a fresh container in its own git branch - run multiple agents without conflicts, experiment safely, discard failures instantly.
๐Ÿ‘€ Real-time Visibility: See complete command history and logs of what agents actually did, not just what they claim.
๐Ÿš Direct Intervention: Drop into any agent's terminal to see their state and take control when they get stuck.
๐ŸŽฎ Environment Control: Standard git workflow - just git checkout <branch_name> to review any agent's work.

  • ๐ŸŒŽ Universal Compatibility: Works with any agent, model, or infrastructure - no vendor lock-in.


---

๐Ÿฆบ This project is in early development and actively evolving. Submit issues and/or reach out to us on Discord in the #container-use channel.

---

Quick Start

Install

# macOS (recommended)
brew install dagger/tap/container-use

All platforms

curl -fsSL https://raw.githubusercontent.com/dagger/container-use/main/install.sh | bash

Setup with Your Agent

Container Use works with any MCP-compatible agent. The setup is always the same: add container-use stdio as an MCP server.

๐Ÿ‘‰ Complete setup guide for all agents (Cursor, Goose, VSCode, etc.)

Example with Claude Code:

# Add Container Use MCP server
cd /path/to/repository
claude mcp add container-use -- container-use stdio

Add agent rules (optional)

curl https://raw.githubusercontent.com/dagger/container-use/main/rules/agent.md >> CLAUDE.md

<details>
<summary>๐Ÿ’ก Command Shortcut</summary>

The container-use command is also available as cu for convenience. Both commands work identically:
- container-use stdio (used in documentation)
- cu stdio (shortcut)

</details>

Try It

Ask your agent to create something:
> Create a hello world app in python using flask

Your agent will work in an isolated environment and give you URLs to view the app and explore the code!

No reviews yet โ€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Videos about container-use

Relevant YouTube tutorials, setups, and demos