Skip to content
Back to search

container

Persistent Linux workspaces for agentic development.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/aerovato-container/badge.svg)](/listings/aerovato-container)

HTML

<a href="/listings/aerovato-container"><img src="/api/listings/aerovato-container/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

Requirements

- Windows, macOS, or Linux - Docker or Podman

Install

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

Configure

Run the guided onboarding flow:

container init

Choose your coding harnesses, development tools, runtime, and mounts, then accept the initial image build.

Run

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>

Multiple terminals can enter the same container.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 141 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="https://raw.githubusercontent.com/aerovato/container/main/.github/README/banner.jpg" alt="Container by Aerovato Research" />
  3. </p>
  4. > ##### Built with [Operator Memory](https://github.com/aerovato/operator-memory)
  5. # `container`
  6. Persistent Linux workspaces for software development.
  7. `container` gives each project its own Docker or Podman environment, with coding harnesses and development tools already installed. Workspaces persist across sessions, including packages and configuration. Agents are isolated to that project with no access to the rest of your system.
  8. The same Linux environment runs on Windows, macOS, and Linux. Your `container` is local and open source, does not require an account, and is yours to customize.
  9. [Website](https://container.aerovato.com) · [Agent Skill](skills/container/SKILL.md) · [中文](README.cn.md)
  10. ## Quickstart
  11. ### Requirements
  12. - Windows, macOS, or Linux
  13. - Docker or Podman
  14. ### Install
  15. macOS and Linux:
  16. ```bash
  17. curl -fsSL https://container.aerovato.com/install.sh | sh
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 29 on GitHub
  18. ```
  19. Windows PowerShell:
  20. ```powershell
  21. irm https://container.aerovato.com/install.ps1 | iex
  22. ```
  23. Alternatively, install through npm:
  24. ```bash
  25. npm install -g @aerovato/container
  26. ```
  27. ### Configure
  28. Run the guided onboarding flow:
  29. ```bash
  30. container init
  31. ```
  32. Choose your coding harnesses, development tools, runtime, and mounts, then accept the initial image build.
  33. ### Run
  34. Navigate to a project and start its workspace:
  35. ```bash
  36. cd /path/to/project
  37. container
  38. ```
  39. Your project is mounted at `/root/<project-name>`. The container and anything installed inside it persist between sessions.
  40. Start your preferred coding agent and work normally:
  41. ```bash
  42. opencode
  43. npm install <package>
  44. ```
  45. Multiple terminals can enter the same container.
  46. ## Customization
  47. `container` is infinitely customizable. Add packages and setup commands to the user layer:
  48. ```text
  49. ~/.code-container/Dockerfile.User
  50. ```
  51. Then rebuild it:
  52. ```bash
  53. container build user
  54. ```
  55. Common settings like tools and harnesses can be configured via `container settings`. More complex options, including runtime flags, mounts, and even base-image settings can be configured through `~/.code-container/settings.json`.
  56. See [Configuration](skills/container/references/configuration.md) for settings details and [Permissions](skills/container/references/permissions.md) for hands-off harness permissions.
  57. ## Common Commands
  58. ```bash
  59. container # Open the current project's workspace
  60. container run /path/to/project # Open a specific project
  61. container run /path -- -p 8080:80 # Pass runtime flags
  62. container list # List managed containers
  63. container stop # Stop the current workspace
  64. container remove # Remove the current workspace
  65. container settings # Change common settings
  66. container init # Re-run onboarding
  67. ```
  68. Rebuild the shared image when updating tools or customizations:
  69. ```bash
  70. container build
  71. container build tools
  72. container build harness
  73. container build user
  74. ```
  75. ## Agent Skill
  76. Want an agent to configure Container for you? Install the portable [Container skill](skills/container/SKILL.md) on the host, then ask your agent to set up packages, harnesses, tools, mounts, permissions, or migrations.
  77. ```bash
  78. npx skills add aerovato/container --skill container
  79. npx skills add aerovato/container --skill container --global # All projects
  80. ```
  81. The skill is host-side because agents inside managed containers cannot access Container's host configuration.
  82. ## Security
  83. `container` limits what an agent can access, but it does not make the agent trusted.
  84. 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.
  85. Keep important work under version control and only mount resources the agent needs.
  86. ## Built with Operator
  87. This repository is maintained with [Operator Memory](https://github.com/aerovato/operator-memory) — durable, agent-maintained documentation that lets AI agents work on the project with full context across sessions. The published brain lives in [`.operator-shared/`](.operator-shared/).
  88. To work on Container with the same context, [we recommend installing Operator Memory.](https://github.com/aerovato/operator-memory#install-operator)
  89. ## License
  90. [BSD 3-Clause](LICENSE.md)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.