Skip to content

Clarify clone mode and Claude worktree isolation#25602

Merged
dvdksn merged 1 commit into
docker:mainfrom
dvdksn:fix/issue-354-clone-mode-docs
Jul 21, 2026
Merged

Clarify clone mode and Claude worktree isolation#25602
dvdksn merged 1 commit into
docker:mainfrom
dvdksn:fix/issue-354-clone-mode-docs

Conversation

@dvdksn

@dvdksn dvdksn commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Summary

Clarify that clone mode uses a standalone sandbox clone while mounting the host repository separately as read-only. Explain that branches and worktrees inside the clone are controlled by the agent tool rather than guaranteed by --clone.

Closes docker/sbx-releases#354

Generated by Codex

@netlify

netlify Bot commented Jul 20, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 40370f6
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a5e09a2ea654b00089a0d4b
😎 Deploy Preview https://deploy-preview-25602--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@dvdksn dvdksn added the status/review Pull requests that are ready for review label Jul 20, 2026
@dvdksn
dvdksn requested a review from a team July 20, 2026 11:15

@docker-agent docker-agent left a comment

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.

Assessment: 🟢 APPROVE

The changes accurately clarify the distinction between clone mode's host-repository isolation and Claude Code's worktree isolation for background sessions. The new language is precise, follows Docker style conventions, and introduces no AI-isms or style violations. No redirects are needed (no pages removed or moved). Markdown formatting is clean.

@docker-agent docker-agent left a comment

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.

Assessment: 🟡 NEEDS ATTENTION

Comment thread content/manuals/ai/sandboxes/agents/claude-code.md Outdated
Comment thread content/manuals/ai/sandboxes/usage.md Outdated
@dvdksn
dvdksn force-pushed the fix/issue-354-clone-mode-docs branch 3 times, most recently from d65a200 to 95eda52 Compare July 20, 2026 11:39
The --clone docs blurred the standalone sandbox clone with the read-only host mount and agent-managed worktrees.

Clarify the filesystem locations and explain that branch and worktree behavior depends on the agent tool.

Co-Authored-By: Codex <noreply@openai.com>
@dvdksn
dvdksn force-pushed the fix/issue-354-clone-mode-docs branch from 95eda52 to 40370f6 Compare July 20, 2026 11:42
@dvdksn
dvdksn merged commit 19b4b14 into docker:main Jul 21, 2026
14 checks passed
@dvdksn
dvdksn deleted the fix/issue-354-clone-mode-docs branch July 21, 2026 11:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/ai status/review Pull requests that are ready for review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Claude by-passed read-only limitation when working in --clone mode

5 participants