Add sandbox support for concurrent agent OCI commands - #85
Merged
Conversation
concurrent agent sandbox OCI docs and commands.
geekgonecrazy
approved these changes
Jun 24, 2026
geekgonecrazy
pushed a commit
that referenced
this pull request
Jun 24, 2026
* add sandbox sync support concurrent agent sandbox OCI docs and commands. * fix windows builds
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
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.
This pull request introduces a new "sandbox" feature to Atomic, enabling concurrent agents to work on isolated, copy-on-write clones of the repository's working tree while sharing a single canonical graph. It adds a new CLI command (
atomic sandbox) with subcommands for creating, staging, and sealing sandboxes, and updates repository logic to recognize and operate within sandboxed environments. Supporting infrastructure for OCI image creation and copy-on-write cloning is also included.Sandbox CLI and Workflow:
atomic sandboxCLI command withcreate,stage, andsealsubcommands to provision, package, and deploy concurrent agent sandboxes. This allows multiple agents to work in parallel with isolated build artifacts and shared history. [1] [2] [3]sandboxcommand. [1] [2] [3]Repository and Sandbox Detection:
.atomic-sandboxpointer instead of a.atomic/directory), enabling all repository operations to work transparently inside sandboxes. [1] [2] [3] [4]SealOptions,StageOptions, etc.) from the repository crate for CLI integration.Copy-on-Write and OCI Image Support:
reflink-copy,tar,flate2, andsha2crates to enable efficient copy-on-write cloning and OCI image packaging for sandboxes. [1] [2]ocimodule in the repository crate to support OCI image layout production for sandbox staging and sealing.Documentation:
README.mdwith a detailed explanation of the sandbox model, its benefits, usage examples, and integration with smolvm for fast, reproducible agent environments.Summary of most important changes:
1. Sandbox CLI and Workflow
atomic sandboxCLI command withcreate,stage, andsealsubcommands for concurrent agent sandboxes. [1] [2] [3]2. Repository and Sandbox Detection
.atomic-sandboxpointer, enabling transparent use inside sandboxes. [1] [2] [3] [4]3. Copy-on-Write and OCI Image Support
reflink-copy) and OCI image packaging (tar,flate2,sha2). [1] [2] [3]4. Documentation
README.mdwith a new section on concurrent agent sandboxes, usage, and design rationale.concurrent agent sandbox OCI docs and commands.