Index of every page on this site: llms.txt
All skills
rivet-dev avatar

/sandbox-agent

@3b027b3 official
by Rivetrivet-dev/skills53 stars
14
Run it yourself

Deploy, configure, and integrate Sandbox Agent - a universal API for orchestrating AI coding agents (Claude Code, Codex, OpenCode, Amp) in sandboxed environments. Use when setting up sandbox-agent server locally or in cloud sandboxes (E2B, Daytona, Docker), creating and managing agent sessions via SDK or API, streaming agent events and handling human-in-the-loop interactions, building chat UIs for coding agents, or understanding the universal schema for agent responses.

Use this Skill: https://skilld.dev/gh/rivet-dev/skills/sandbox-agent

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencescli.md

≈1.8k tokens on demand. Your agent reads this file only when SKILL.md points to it.

CLI Reference

Source: sandbox-agent/docs/content/docs/cli.mdx Canonical URL: https://rivet.dev/sandbox-agent/docs/cli Description: CLI reference for sandbox-agent.


Global flags (available on all commands):

  • -t, --token : require/use bearer auth
  • -n, --no-token: disable auth

server

Run the HTTP server.

sandbox-agent server [OPTIONS]
Option Default Description
-H, --host 127.0.0.1 Host to bind
-p, --port 2468 Port to bind
-O, --cors-allow-origin - Allowed CORS origin (repeatable)
-M, --cors-allow-method all Allowed CORS method (repeatable)
-A, --cors-allow-header all Allowed CORS header (repeatable)
-C, --cors-allow-credentials false Enable CORS credentials
--no-telemetry false Disable anonymous telemetry
sandbox-agent server --port 3000

Notes:

  • Server logs are redirected to files by default.
  • Set SANDBOX_AGENT_LOG_STDOUT=1 to force stdout/stderr logging.
  • Use SANDBOX_AGENT_LOG_DIR to override log directory.

install

Install first-party runtime dependencies.

install desktop

Install the Linux desktop runtime packages required by /v1/desktop/*.

sandbox-agent install desktop [OPTIONS]
Option Description
--yes Skip the confirmation prompt
--print-only Print the package-manager command without executing it
--package-manager <apt|dnf|apk> Override package-manager detection
--no-fonts Skip the default DejaVu font package
sandbox-agent install desktop --yes
sandbox-agent install desktop --print-only

Notes:

  • Supported on Linux only.
  • The command detects apt, dnf, or apk.
  • If the host is not already running as root, the command requires sudo.

install-agent

Install or reinstall a single agent, or every supported agent with --all.

sandbox-agent install-agent [<AGENT>] [OPTIONS]
Option Description
--all Install every supported agent
-r, --reinstall Force reinstall
--agent-version Override agent package version (conflicts with --all)
--agent-process-version Override agent process version (conflicts with --all)

Examples:

sandbox-agent install-agent claude --reinstall
sandbox-agent install-agent --all

Custom Pi implementation path

If you use a forked/custom pi binary with pi-acp, you can override what executable gets launched.

Option 1: explicit command override (recommended)

Set PI_ACP_PI_COMMAND in the environment where sandbox-agent runs:

PI_ACP_PI_COMMAND=/absolute/path/to/your/pi-fork sandbox-agent server

This is forwarded to pi-acp, which uses it instead of looking up pi on PATH.

Option 2: PATH override

Put your custom pi first on PATH before starting sandbox-agent:

export PATH="/path/to/custom-pi-dir:$PATH"
sandbox-agent server
Option 3: symlink override

Point pi to your custom binary via symlink in a directory that is early on PATH:

ln -sf /absolute/path/to/your/pi-fork /usr/local/bin/pi

Then start sandbox-agent normally.

opencode (experimental)

Start/reuse daemon and run opencode attach against /opencode.

sandbox-agent opencode [OPTIONS]
Option Default Description
-H, --host 127.0.0.1 Daemon host
-p, --port 2468 Daemon port
--session-title - Reserved option (currently no-op)
--yolo false OpenCode attach mode flag
sandbox-agent opencode

daemon

Manage the background daemon.

daemon start

sandbox-agent daemon start [OPTIONS]
Option Default Description
-H, --host 127.0.0.1 Host
-p, --port 2468 Port
--upgrade false Use ensure-running + upgrade behavior
sandbox-agent daemon start
sandbox-agent daemon start --upgrade

daemon stop

sandbox-agent daemon stop [OPTIONS]
Option Default Description
-H, --host 127.0.0.1 Host
-p, --port 2468 Port

daemon status

sandbox-agent daemon status [OPTIONS]
Option Default Description
-H, --host 127.0.0.1 Host
-p, --port 2468 Port

credentials

credentials extract

sandbox-agent credentials extract [OPTIONS]
Option Description
-a, --agent Filter by claude, codex, opencode, or amp
-p, --provider Filter by provider
-d, --home-dir Override home dir
--no-oauth Skip OAuth sources
-r, --reveal Show full credential values
sandbox-agent credentials extract --agent claude --reveal

credentials extract-env

sandbox-agent credentials extract-env [OPTIONS]
Option Description
-e, --export Prefix output with export
-d, --home-dir Override home dir
--no-oauth Skip OAuth sources
eval "$(sandbox-agent credentials extract-env --export)"

api

API subcommands for scripting.

Shared option:

Option Default Description
-e, --endpoint http://127.0.0.1:2468 Target server

api agents

sandbox-agent api agents list [--endpoint <URL>]
sandbox-agent api agents report [--endpoint <URL>]
sandbox-agent api agents install <AGENT> [--reinstall] [--endpoint <URL>]
api agents list

List all agents and their install status.

sandbox-agent api agents list
api agents report

Emit a JSON report of available models, modes, and thought levels for every agent, grouped by category.

sandbox-agent api agents report --endpoint http://127.0.0.1:2468 | jq .

Example output:

{
  "generatedAtMs": 1740000000000,
  "endpoint": "http://127.0.0.1:2468",
  "agents": [
    {
      "id": "claude",
      "installed": true,
      "models": {
        "currentValue": "default",
        "values": [
          { "value": "default", "name": "Default" },
          { "value": "sonnet", "name": "Sonnet" },
          { "value": "opus", "name": "Opus" },
          { "value": "haiku", "name": "Haiku" }
        ]
      },
      "modes": {
        "currentValue": "default",
        "values": [
          { "value": "default", "name": "Default" },
          { "value": "acceptEdits", "name": "Accept Edits" },
          { "value": "plan", "name": "Plan" },
          { "value": "dontAsk", "name": "Don't Ask" },
          { "value": "bypassPermissions", "name": "Bypass Permissions" }
        ]
      },
      "thoughtLevels": { "values": [] }
    }
  ]
}

See individual agent pages (e.g. Claude, Codex) for supported models, modes, and thought levels.

api agents install
sandbox-agent api agents install codex --reinstall

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

3 alerts1d5 checks · Risk HIGH
  • Gen Agent Trust Hub1d

    The skill provides a universal API for orchestrating coding agents in sandboxed environments. It includes instructions for installing its own server components and various development tools using piped shell execution (remote code execution). The tool possesses broad capabilities for arbitrary command execution, filesystem access, and desktop control, and it features mechanisms for the agent to extract and export LLM credentials from the local host environment.

  • Socket1d

    1 alert: gptAnomaly

  • Snyk1d

    Risk: CRITICAL · 2 issues

  • Runlayer8mo

    34/41 files flagged

  • ZeroLeaks7mo

    1 finding · Score: 82/100

Signed by skilld at 3b027b3. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 days ago
  • TypeScript
  • sandbox-agent
  • api-orchestration
  • ai-agents
  • claude
  • openai
  • e2b
  • daytona
  • docker
  • session-management

README badge

README badge for rivet-dev/skills/sandbox-agent

Provides a universal API and orchestration layer for running Claude, Codex, OpenCode, and Amp coding agents in sandboxed environments (E2B, Daytona, Docker). Covers server setup, session management, event streaming, and integration with chat UIs and LLM providers.

Generated from the current SKILL.md.

Which coding agents does Sandbox Agent support?
Sandbox Agent provides a universal API for Claude Code, Codex, OpenCode, and Amp. It also supports a mock agent for testing without provider credentials.
What sandbox providers can I deploy to?
Sandbox Agent runs on E2B, Daytona, Docker, local development, and cloud platforms like Vercel and Cloudflare. You can also run it as a local subprocess via Node.js or Bun.
Do I need API keys to test Sandbox Agent?
No. Use the mock agent for SDK and integration testing without Anthropic or OpenAI credentials. For real agents, you'll need to set ANTHROPIC_API_KEY and/or OPENAI_API_KEY.
Can I use this for per-user billing or multi-tenant setups?
Yes. Sandbox Agent supports LLM credential gateways like OpenRouter, LiteLLM, and Portkey for per-tenant token tracking, budget enforcement, and usage-based billing.
What persistence options are available for agent sessions?
Sessions can be persisted in-memory, to Rivet Actor state, IndexedDB, SQLite, or Postgres depending on your deployment target.

Generated from the current SKILL.md. These answers refresh after source changes.