Skip to content

docs: clarify persisted env vars reach the agent process #25816

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dvdksn merged 2 commits into from
Aug 13, 2026
+10 −6
Merged

docs: clarify persisted env vars reach the agent process #25816

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f535c59
docs: clarify that persisted env vars reach the agent process, not ju…
mdelapenya Aug 13, 2026
5ef0903
docs: apply suggestion
mdelapenya Aug 13, 2026
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
16 changes: 10 additions & 6 deletions content/manuals/ai/sandboxes/faq.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -111,12 +111,16 @@ sandbox instead of on your host.
> the sandbox. The agent process can read it directly. Only use this for
> credentials where proxy-based injection isn't available.

Variables in `/etc/sandbox-persistent.sh` are sourced automatically when
bash runs inside the sandbox, including interactive sessions and agents
started with `sbx run`. If you run a command directly with
`sbx exec <name> <command>`, the command runs without a shell, so the
persistent environment file is not sourced. Wrap the command in `bash -c`
to load the environment:
Variables in `/etc/sandbox-persistent.sh` are sourced automatically for
interactive sessions and for agents started with `sbx run`.

A variable only takes effect for sessions and agents started *after* it's

@docker-agent docker-agent Aug 13, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[LOW] Italics used for mid-sentence emphasis

The style guide says to use italics sparingly — notable exceptions are titles of articles, blog posts, or specification documents, not in-sentence emphasis. Consider rewording to avoid the need for emphasis: "A variable only takes effect for sessions and agents that start after you add it."

added. If an agent is already running when you append to the file, restart
it (or stop and start the sandbox) to pick up the new value.

Running commands directly with `sbx exec <name> <command>` does not invoke
a shell, so the persistent environment file is not sourced. Wrap the
command in `bash -c` to load the environment:

```console
$ sbx exec <sandbox-name> bash -c "your-command"
Expand Down