git404hub

what is sandbox fr?

yagop/sandbox — explained in plain English

Analysis updated 2026-05-18

2GoAudience · developerComplexity · 4/5Setup · moderate

tl;dr

A Go forward proxy that injects real credentials into sandboxed containers' requests without the sandbox ever seeing the tokens.

vibe map

mindmap
  root((sandbox-proxy))
    What it does
      Injects credentials on the wire
      Never exposes tokens to sandbox
      Shares one proxy across sandboxes
    Tech stack
      Go
      Docker
      Shell script
    Use cases
      AI agent sandboxing
      Secure CI credentials
      Isolated dev containers
    Audience
      Developers
      Security engineers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Give an AI coding agent sandboxed access to GitHub or npm without exposing your real tokens.

VIBE 2

Run untrusted or automated code with authenticated network access it cannot exfiltrate credentials from.

VIBE 3

Run multiple isolated project sandboxes at once sharing a single credential-injecting proxy.

VIBE 4

Tunnel a database or other raw TCP service into a sandbox through the same proxy.

what's the stack?

GoDockerShell

how it stacks up fr

yagop/sandboxanomalroil/1keyanshuman852/dasan-router-cli
Stars222
LanguageGoGoGo
Last pushed2019-05-17
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity4/53/53/5
Audiencedeveloperops devopsops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Docker and sourcing sandbox.sh, secrets like GH_TOKEN are pulled from tools you're already logged into.

in plain english

Sandbox-proxy solves a specific problem: how do you let code run in an isolated container and still let it authenticate to services like GitHub or npm, without ever letting that code see your real access tokens. It works by routing all of a sandbox's web traffic through a small proxy program written in Go with no outside dependencies. The proxy holds the real tokens and slips them into outgoing requests only as they leave the network, on their way to trusted destinations like github.com or the npm registry. The code running inside the sandbox never has the token in its own environment, so even if that code were compromised, it could only use the token against the specific destinations you have allowed, not read or steal the token itself. Everything is driven through a single shell script that gives you a sandbox command. Running sandbox proxy up starts one shared proxy that any number of sandboxed containers can use at once. From inside a normal project folder, sandbox run opens a shell in that sandbox, or you can run a specific command like sandbox run npm ci directly. Tokens like a GitHub token are picked up automatically from tools you are already logged into, or from a command you configure, and are resolved fresh each time the proxy starts so they never sit around in your shell. By default the proxy allows outgoing connections to any host and only injects credentials into the ones you configure, though it can be locked down to a strict allow list of destinations. It intercepts encrypted web traffic using a certificate it generates the first time it runs, which the sandbox is set up to trust. Non web traffic, like raw database connections, can either bypass the proxy entirely or be forced through it depending on a setting. The project also includes a helper for tunneling other network services, such as a database on the local network, through the same proxy. This is a security tool aimed at developers who want to give an AI agent or automated tool sandboxed access to their accounts without handing over the actual credentials.

prompts (copy fr)

prompt 1
Explain how sandbox-proxy injects a GitHub token into requests without the sandbox seeing it.
prompt 2
Walk me through setting up sandbox-proxy so an AI agent can run npm and git commands safely.
prompt 3
Show me how to configure proxy/config.json to allow only specific hosts for credential injection.
prompt 4
Help me add a new secret type to sandbox-proxy's rules, like an AWS token.
prompt 5
Explain the difference between allow_all true and strict default-deny mode in this project.

Frequently asked questions

what is sandbox fr?

A Go forward proxy that injects real credentials into sandboxed containers' requests without the sandbox ever seeing the tokens.

What language is sandbox written in?

Mainly Go. The stack also includes Go, Docker, Shell.

How hard is sandbox to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is sandbox for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.