/registry

tools by shubham

Small, inspectable software for running code safely, understanding GPU fleets, and giving coding agents useful access without giving them the whole machine.

tools

Built to be inspected, self-hosted, and used in production.

Git Forge

The public source home for the systems behind this registry: Sandbox, Watchman, and UltraBalancer.

A read-only Forgejo mirror kept in sync with GitHub and served through Cloudflare, so the source stays close without putting the origin on display.

browsegit.yshubham.com/explore/repos

clonegit clone https://git.yshubham.com/bas3line/sandbox.git

mirrorsSandbox · Watchman · UltraBalancer · GitHub source retained

clone from the forge
git clone https://git.yshubham.com/bas3line/sandbox.git

browse repositories GitHub source

Sandbox

Disposable coding environments for humans and AI agents, without handing either of them the keys to the whole machine.

A self-hosted Rust control plane with AEGIS risk-aware scheduling, Docker workers, PostgreSQL state, optional NATS events, and a typed remote CLI. The release includes sandbox, sandboxd, and sandbox-mcp for macOS ARM64 and Linux x86-64.

schedulemulti-worker leases · heartbeats · labels · anti-affinity · warm-image ranking

isolateAEGIS risk scoring · Docker workers · external VMM driver contract

controlCPU · memory · disk · PID · network · TTL · bounded output

sharesandbox http PORT · first-party *.tunnel.yshubham.com relay · HTTP/WebSocket/Vite HMR

operatePostgreSQL · in-memory dev mode · optional NATS · Prometheus metrics

binaries + skill + detected MCP clients
curl -fsSL https://tools.yshubham.com/sandbox/setup.sh | sh

docs agent guides setup script binary installer mcp config

Watchman

A fast operator’s lens for GPU inference servers: inspect them, benchmark them, and catch trouble before users do.

An open-source Rust utility for monitoring, debugging, benchmarking, and safely operating production GPU inference infrastructure on macOS and Linux.

install watchman
curl -fsSL https://tools.yshubham.com/watchman/install.sh | sh

docs source installer

use with agents

Skills and protocols for operating the tools from coding agents.

sandbox-platform

skill · agent: *

Sandbox lifecycle, trust classification, resource sizing, safe execution, recovery, capacity diagnosis, and secret boundaries through CLI and MCP.

npx skills add bas3line/rool-repo --skill sandbox-platform --agent '*' --global --yes

watchman

skill · agent: *

GPU incidents, runtime telemetry, capacity planning, canaries, saturation benchmarks, regression gates, history, and rollout validation.

npx skills add bas3line/rool-repo --skill watchman --agent '*' --global --yes

objects-storage

skill · agent: *

A safe hand-off workflow for small public build artifacts: accurate MIME types, seven-day expiry, early deletion, and no accidental secret sharing.

npx skills add bas3line/rool-repo --skill objects-storage --agent '*' --yes

objects raw skill

sandbox-mcp

mcp · v0.1.5 · stdio

The Sandbox control plane exposed through 12 lifecycle tools, three resources, and two prompts. It works with Codex, Claude, OpenCode, Cursor, VS Code, Gemini, Windsurf, Cline, Roo Code, Goose, and generic MCP hosts.

codex mcp add sandbox -- sandbox-mcp

all client setup shared json opencode vs code goose

more client commands
claude code
claude mcp add --scope user --transport stdio sandbox -- sandbox-mcp
gemini cli
gemini mcp add sandbox sandbox-mcp --scope user
opencode
opencode mcp add
goose session
goose session --with-extension "sandbox-mcp"

registry endpoints

Raw, stable, and easy to inspect.

  • /sandbox/setup.shbinaries, cross-agent skill, and detected MCP CLI setup
  • /sandbox/install.shchecksum-verifying Sandbox binary installer
  • /sandbox/mcp.jsongeneric MCP client configuration
  • /sandbox/clients/index.mdsetup for major coding agents and MCP clients
  • docs.yshubham.comcanonical documentation for Sandbox, Watchman, Objects, Trace, MCP, and skills
  • /sandbox/latestcurrent immutable Sandbox release pointer
  • /watchman/install.shchecksum-verifying Watchman installer
  • git.yshubham.comForgejo mirrors for Sandbox, Watchman, and UltraBalancer
  • /skillsplain-text agent installation instructions
  • /skills/objects-storage/SKILL.mdraw Objects Storage agent instructions
  • /skills/objects-storage/agents/openai.yamlObjects Storage agent metadata
  • /healthzregistry liveness probe