by aerovato
Safely run OpenCode, Codex, Claude Code with full permissions.
# Add to your Claude Code skills
git clone https://github.com/aerovato/containerGuides for using ai agents skills like container.
Last scanned: 6/1/2026
{
"issues": [
{
"type": "npm-audit",
"message": "brace-expansion: brace-expansion: Large numeric range defeats documented `max` DoS protection",
"severity": "medium"
}
],
"status": "PASSED",
"scannedAt": "2026-06-01T09:27:16.201Z",
"npmAuditRan": true,
"pipAuditRan": true
}containerPersistent, isolated workspaces for AI coding agents.
container gives each project its own Docker or Podman environment. Agents can install dependencies, configure tools, and modify their environment without polluting your base system or interfering with other projects.
Isolation also makes hands-off agent workflows more practical by limiting destructive operations to the project workspace and explicitly mounted resources.
macOS and Linux:
curl -fsSL https://container.aerovato.com/install.sh | sh
Windows PowerShell:
irm https://container.aerovato.com/install.ps1 | iex
Alternatively, install through npm:
npm install -g @aerovato/container
Run the guided onboarding flow:
container init
Choose your coding harnesses, development tools, runtime, and mounts, then accept the initial image build.
Navigate to a project and start its workspace:
cd /path/to/project
container
Your project is mounted at /root/<project-name>. The container and anything installed inside it persist between sessions.
Start your preferred coding agent and work normally:
opencode
npm install <package>
Want an agent to configure Container for you? Install the portable Container skill on the host, then ask your agent to set up packages, harnesses, tools, mounts, permissions, or migrations.
npx skills add aerovato/container --skill container
npx skills add aerovato/container --skill container --global # All projects
The skill is host-side because agents inside managed containers cannot access Container's host configuration.
container # Open the current project's workspace
container run /path/to/project # Open a specific project
container run /path -- -p 8080:80 # Pass runtime flags
container list # List managed containers
container stop # Stop the current workspace
container remove # Remove the current workspace
container settings # Change common settings
container init # Re-run onboarding
Rebuild the shared image when updating tools or customizations:
container build
container build tools
container build harness
container build user
Add packages and setup commands to:
~/.code-container/Dockerfile.User
Then rebuild the user layer:
container build user
Harnesses, tools, runtime flags, mounts, and base-image settings are configured through ~/.code-container/settings.json.
See Configuration for settings details and Permissions for hands-off harness permissions.
container limits what an agent can access, but it does not make the agent trusted.
The current project is mounted read-write and can be changed or deleted. Enabled configurations and optional credentials may also be available inside the container. Containers retain network access, and container does not protect against prompt injection or agent misalignment.
Keep important work under version control and only mount resources the agent needs.
container is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by aerovato. Safely run OpenCode, Codex, Claude Code with full permissions. It has 309 GitHub stars.
Yes. container passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/aerovato/container" and add it to your Claude Code skills directory (see the Installation section above).
container is primarily written in TypeScript. It is open-source under aerovato on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh container against similar tools.
No comments yet. Be the first to share your thoughts!