GitHub CLI overlay with scoped GitHub access and proxy-managed authentication.
1.7K
GitHub CLI overlay with scoped GitHub access and proxy-managed authentication.
| Name | Required | Default | Description |
|---|---|---|---|
version | Required | — | GitHub CLI release carried by the overlay |
[email protected]| Type | Required | Description | |
|---|---|---|---|
com.docker.sandbox/network-policy@2 | Required | — | |
com.docker.sandbox/credential@1 | Optional | GitHub API access for gh | |
com.docker.sandbox/agent-context@1 | Optional | — | |
com.docker.sandbox/agent-context@2 | Optional | — | |
sbx run <agent> --kit sbx/github-cli:latestRun the following command to install sbx on your machine.
brew install docker/tap/sbxwinget install Docker.sbxThis mixin Kit adds the GitHub CLI executable gh to a compatible workload. It keeps the
workload’s launch command and works with native agents without a Node runtime.
This Kit is built on Docker Hardened Images.
Add --kit sbx/github-cli:latest when creating a sandbox with a workload such as
Shell. Inside the sandbox, run gh --version, gh pr list, gh issue list, or
gh api.
The Kit is named github-cli; the installed command remains gh, at /usr/local/bin/gh. Git commands use the
workload’s Git installation.
Bind your GitHub credential on the host through Docker Sandboxes. With a binding, GH_TOKEN inside the sandbox is a
proxy-managed sentinel. The proxy injects the real token for github.com, api.github.com, and uploads.github.com.
Do not print or copy the token, and do not run gh auth login. The Kit never puts a real credential in its image
layers. Without a host credential, authenticated GitHub operations remain unavailable.
Runtime access covers GitHub repository paths, the API methods used by gh, and upload requests. DELETE requests under
api.github.com/repos/** are explicitly denied, including repository deletion. This is a scoped grant, not permission
to reach arbitrary release-asset hosts or GitHub Enterprise servers; configure additional destinations separately when
needed.
See the Sandbox Kit v3 specification, GitHub CLI documentation, Docker Sandboxes documentation, and Docker Hardened Images documentation.