Skip to content
dvdksnPublic

About

Docker Sandbox v3 shell kit with Claude, Codex, GitHub SSH, and Git signing

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

34 Commits

Folders and files

Repository files navigation

Development sandbox kits

My personal Docker Sandbox kits with a shared base environment, Claude Code, Codex, GitHub cloning, SSH access, Git signing, rumdl for Markdown, browser tools, Hugo Extended, Vale, Task, and Neovim.

All component descriptors, Dockerfiles, lifecycle hooks, scripts, and agent context files live in this repository. Builds do not fetch kit specs from upstream repositories or use the docker/sbx-kit-shell image.

Run

Use the checked-in environment file to compose the published components at sandbox creation:

sbx env run ./sbxenv.yaml --name docs --env-arg repo=docker/docs

Without --name, the sandbox is named dev. Use a distinct name for each repository you work on.

The kit clones the selected GitHub repository inside the sandbox at /home/agent/workspace (~/workspace), where the shell starts. It preserves an existing working tree instead of recloning or resetting it. The only clone input is repo: creation clones the default branch with --depth=1. Git HTTPS auth uses upstream's gh auth git-credential helper. The separate clone script holds the retry checks that preserve existing work. Use git fetch --unshallow inside the sandbox when you need older history. The environment does not mount a host repository. Run it again with the same file, name, and arguments to reattach.

For a project-oriented launcher, use sup.

Use SBX v0.48.0 or newer. sbxenv.yaml composes Claude and Codex as separate artifacts so each agent can use its host OAuth credentials.

Claude and Codex each declare their native global instruction destination: ~/.claude/CLAUDE.md and ~/.codex/AGENTS.md. The runtime writes sandbox guidance and the full Kit context index to both profiles, preserving authored instructions outside its managed sections. The base contributes shared context without selecting a profile destination. Future agent mixins should declare their own discovery destination through agent-context@1.

Run claude or codex in the shell. Use rumdl fmt <file> to format Markdown and rumdl check <file> to lint it. Run nvim to edit with a lightweight starter configuration. See the Neovim kit guide for basic usage and terminal access over SSH. Use task --list to list project tasks and task <name> to run one. Use hugo to build Hugo sites and hugo server --bind 0.0.0.0 to preview them (publish port 1313 on the sandbox host). Run vale sync in the project to download configured styles, then vale <file> to lint prose. The host must have an SSH agent with a loaded key for the required SSH capabilities. Add the appropriate public key to GitHub for authentication and signing. The signing mixin requests git-identity@1, so the runtime is responsible for supplying your Git author name and email as sandbox defaults. Repository-local identity settings still take precedence. In a live check, SBX v0.45.1 accepted the required declaration but left both defaults unset despite a configured host identity. That runtime does not yet provide the requested behavior; configure the guest identity until runtime support is available.

Claude and Codex use credentials bound through the sandbox host. Their credential capabilities are optional; the copied hooks also support an unbound state. These agents are configured to skip approval prompts and rely on the sandbox boundary for isolation.

The environment grants the union of its kits' network and SSH permissions. GitHub authentication is restricted to git@github.com; signing is restricted to the git namespace. Neither mixin copies private keys into the image.

Source layout

Path Purpose
sbxenv.yaml Composes the published kits at sandbox creation
kits/base/ Shared base environment and default shell workload, built from the DHI shell-docker template
kits/claude-mixin/ Latest Claude Code native binary, credentials, and hooks
kits/codex-mixin/ Latest Codex standalone installation, credentials, and hooks
kits/browser-mixin/ Pinned Playwright MCP and Chromium for both agents
kits/github-ssh/ GitHub SSH access and known host keys
kits/git-signing/ Runtime Git identity, SSH signing permission, and signing defaults
kits/neovim/ Latest stable Neovim with runtime and a plugin-free starter configuration
kits/hugo/ Latest stable Hugo Extended with verified release checksums
kits/vale/ Latest stable Vale prose linter with verified release checksums
kits/task/ Pinned Task 3.54.0 CLI with verified release checksums
kits/rumdl/ Latest rumdl binary with verified release checksums
kits/github-clone/ HTTPS clone with proxy-managed GitHub credentials

The base kit uses the shell-docker template tag. DHI base images and upstream agent binary downloads remain build dependencies; this repository owns the kit definitions and recipes, not those third-party projects. NOTICE records the copied examples' source revision and modifications.

Published kits and development

Each component is published as a public GHCR image for AMD64 and ARM64, such as ghcr.io/dvdksn/kit-base and ghcr.io/dvdksn/kit-codex-mixin. sbxenv.yaml combines the base kit (the shared environment and default shell entrypoint) with mixins that add tools, credentials, and lifecycle hooks. The environment grants the union of the kits' permissions. The browser mixin registers browser-use MCP with both agents and installs Chromium at sandbox creation; browser profiles are ephemeral and website access follows the sandbox network policy.

The environment uses moving :latest tags by default. Select a published commit build with the revision argument:

sbx env run ./sbxenv.yaml --name docs --env-arg repo=docker/docs \
  --env-arg revision=FULL_COMMIT_SHA

Use image digests when you need immutable references. Main builds publish both commit and latest tags; manual feature branch builds publish commit tags only.

See AGENTS.md for the repository architecture, editing guidance, and build, validation, and publishing workflow.

The original kit sources and Docker-derived files are Apache-2.0 licensed. See NOTICE for upstream attribution. Third-party images and binaries retain their own licenses.

About

Docker Sandbox v3 shell kit with Claude, Codex, GitHub SSH, and Git signing

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages