Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions content/manuals/ai/sandboxes/security/isolation.md
Original file line number Diff line number Diff line change
Expand Up @@ -123,6 +123,7 @@ including:
- CI configuration (`.github/workflows/`, `.gitlab-ci.yml`)
- IDE configuration (`.vscode/tasks.json`, `.idea/` run configurations)
- AI project configuration and settings (`.claude/`, `.codex/`, `.gemini/`)
- Sandbox environment files (`.sbxenv.yaml`)
- Hidden files, shell scripts, and executables

Some of these files execute code when you trigger normal development
Expand All @@ -141,6 +142,12 @@ Review them after any agent session before performing those actions:
- AI project configuration and settings (`.claude/settings.json`, `.codex/config.toml`,
`.gemini/settings.json`) can define hooks and startup commands that
execute automatically.
- Sandbox environment files (`.sbxenv.yaml`) can declare `secrets` and
`registries` whose values come from a `command`. Those commands run on
the host, as you, the next time you run `sbx env create` or
`sbx env run` in that directory — before the sandbox exists. Because the
file sits in the workspace, an agent in direct mount can add or change
one.

> [!WARNING]
> Treat sandbox-modified workspace files the same way you would treat a pull
Expand Down