docs(sandboxes): add workflow patterns page#25228
Open
dvdksn wants to merge 2 commits into
Open
Conversation
✅ Deploy Preview for docsdocker ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
docker-agent
reviewed
Jun 2, 2026
dvdksn
force-pushed
the
worktree-iterative-swimming-quill
branch
4 times, most recently
from
e4ba411 to
770be53
Compare
Adds workflows.md to the sandboxes manual covering git strategies (single-agent feature branch, multi-agent parallel branches, direct mode), commit signing via SSH agent forwarding, authenticated CLI tools (gh, Docker registry, 1Password), and CI/headless use. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
dvdksn
force-pushed
the
worktree-iterative-swimming-quill
branch
from
770be53 to
d7cd0ad
Compare
Add missing --username flag to GHCR registry secret example, and remove erroneous trailing `.` from sbx create CI example to match other clone-mode examples. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
dvdksn
force-pushed
the
worktree-iterative-swimming-quill
branch
from
ffa45ef to
a6b6ef2
Compare
usha-mandya
reviewed
Jun 2, 2026
| touched. When the agent is done, you either fetch its branches to the host or | ||
| ask the agent to push directly to your fork. | ||
|
|
||
| Clone mode is designed for parallelism: a single clone-mode sandbox can hold |
Member
There was a problem hiding this comment.
Parallelism is accurate, but wondering if we should simplify this? No strong opinions here.
usha-mandya
approved these changes
Jun 2, 2026
akristen
reviewed
Jun 2, 2026
|
|
||
| ### Direct mode | ||
|
|
||
| The simplest approach. The sandbox mounts your host working tree directly — |
Contributor
There was a problem hiding this comment.
Suggested change
| The simplest approach. The sandbox mounts your host working tree directly — | |
| The simplest approach. The sandbox mounts your host working tree directly and |
akristen
reviewed
Jun 2, 2026
| ### Direct mode | ||
|
|
||
| The simplest approach. The sandbox mounts your host working tree directly — | ||
| the agent edits files in place and changes appear immediately. You manage |
Contributor
There was a problem hiding this comment.
Suggested change
| the agent edits files in place and changes appear immediately. You manage | |
| the agent edits files in place. Your changes appear immediately. You manage |
akristen
reviewed
Jun 2, 2026
|
|
||
| ### Host worktree | ||
|
|
||
| You can create a Git worktree on your host and point the sandbox at it. The |
Contributor
There was a problem hiding this comment.
non-blocking: should git be capitalized every time?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a new Workflows page to the sandboxes manual covering the patterns that
don't fit cleanly in the mechanical usage reference: git strategies (single-agent
feature branch and multi-agent parallel branches in clone mode, direct mode),
commit signing via SSH agent forwarding, authenticated CLI tools (gh, Docker
registry, 1Password via op read), and CI/headless use.
Generated by Claude Code