docs: clarify autonomous Codex sandbox limitations
This commit is contained in:
+30
-1
@@ -7,6 +7,10 @@ profile:
|
|||||||
./codex-auto
|
./codex-auto
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Start a fresh session with this command. Running plain `codex`, opening Codex
|
||||||
|
through an editor integration, or continuing an already-running session does
|
||||||
|
not automatically activate this profile.
|
||||||
|
|
||||||
For a non-interactive task:
|
For a non-interactive task:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
@@ -22,7 +26,7 @@ The profile:
|
|||||||
- limits filesystem access to minimal runtime files plus this project
|
- limits filesystem access to minimal runtime files plus this project
|
||||||
- allows writes in this project
|
- allows writes in this project
|
||||||
- keeps `.codex` and `www.azinstitute4autism.com` read-only
|
- keeps `.codex` and `www.azinstitute4autism.com` read-only
|
||||||
- permits normal Git operations, including staging and committing
|
- permits read-only Git inspection
|
||||||
- enables live web search and outbound network retrievals
|
- enables live web search and outbound network retrievals
|
||||||
|
|
||||||
Outbound network access is domain-unrestricted because package installation and
|
Outbound network access is domain-unrestricted because package installation and
|
||||||
@@ -50,3 +54,28 @@ curl -fsS https://registry.npmjs.org/astro >/dev/null
|
|||||||
```
|
```
|
||||||
|
|
||||||
Live web search is separate from shell network access and remains enabled.
|
Live web search is separate from shell network access and remains enabled.
|
||||||
|
|
||||||
|
In the current environment, the beta network proxy permits retrievals but
|
||||||
|
sandboxed command-line tools may fail HTTPS certificate verification. Do not
|
||||||
|
disable certificate verification for package installation or sensitive
|
||||||
|
retrievals; use live web search or review the retrieval from the host instead.
|
||||||
|
|
||||||
|
## Git limitation
|
||||||
|
|
||||||
|
Codex always protects `.git` recursively in its `workspace-write` sandbox.
|
||||||
|
Agents can inspect Git state and diffs, but cannot stage or commit. This cannot
|
||||||
|
be overridden by a permissions profile.
|
||||||
|
|
||||||
|
For autonomous commits, use an outer container or VM as the security boundary,
|
||||||
|
mount only this project into it, and run Codex with full access inside that
|
||||||
|
isolated environment. Otherwise, review and commit agent changes from the host.
|
||||||
|
|
||||||
|
Writes that appear to succeed directly under `/home/alice` are made to the
|
||||||
|
sandbox's temporary in-memory root. They do not modify the host home directory.
|
||||||
|
|
||||||
|
Check the startup banner before assigning work. It should report:
|
||||||
|
|
||||||
|
```txt
|
||||||
|
approval: never
|
||||||
|
sandbox: workspace-write ... (network access enabled)
|
||||||
|
```
|
||||||
|
|||||||
Reference in New Issue
Block a user