mirror of
https://github.com/harivansh-afk/sandbox-agent.git
synced 2026-04-15 16:04:06 +00:00
172 lines
3.9 KiB
Text
172 lines
3.9 KiB
Text
---
|
|
title: "CLI Reference"
|
|
description: "CLI reference for sandbox-agent."
|
|
sidebarTitle: "CLI"
|
|
---
|
|
|
|
Global flags (available on all commands):
|
|
|
|
- `-t, --token <TOKEN>`: require/use bearer auth
|
|
- `-n, --no-token`: disable auth
|
|
|
|
## server
|
|
|
|
Run the HTTP server.
|
|
|
|
```bash
|
|
sandbox-agent server [OPTIONS]
|
|
```
|
|
|
|
| Option | Default | Description |
|
|
|--------|---------|-------------|
|
|
| `-H, --host <HOST>` | `127.0.0.1` | Host to bind |
|
|
| `-p, --port <PORT>` | `2468` | Port to bind |
|
|
| `-O, --cors-allow-origin <ORIGIN>` | - | Allowed CORS origin (repeatable) |
|
|
| `-M, --cors-allow-method <METHOD>` | all | Allowed CORS method (repeatable) |
|
|
| `-A, --cors-allow-header <HEADER>` | all | Allowed CORS header (repeatable) |
|
|
| `-C, --cors-allow-credentials` | false | Enable CORS credentials |
|
|
| `--no-telemetry` | false | Disable anonymous telemetry |
|
|
|
|
```bash
|
|
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-agent
|
|
|
|
Install or reinstall a single agent.
|
|
|
|
```bash
|
|
sandbox-agent install-agent <AGENT> [OPTIONS]
|
|
```
|
|
|
|
| Option | Description |
|
|
|--------|-------------|
|
|
| `-r, --reinstall` | Force reinstall |
|
|
| `--agent-version <VERSION>` | Override agent package version |
|
|
| `--agent-process-version <VERSION>` | Override agent process version |
|
|
|
|
```bash
|
|
sandbox-agent install-agent claude --reinstall
|
|
```
|
|
|
|
## opencode (experimental)
|
|
|
|
Start/reuse daemon and run `opencode attach` against `/opencode`.
|
|
|
|
```bash
|
|
sandbox-agent opencode [OPTIONS]
|
|
```
|
|
|
|
| Option | Default | Description |
|
|
|--------|---------|-------------|
|
|
| `-H, --host <HOST>` | `127.0.0.1` | Daemon host |
|
|
| `-p, --port <PORT>` | `2468` | Daemon port |
|
|
| `--session-title <TITLE>` | - | Reserved option (currently no-op) |
|
|
| `--yolo` | false | OpenCode attach mode flag |
|
|
|
|
```bash
|
|
sandbox-agent opencode
|
|
```
|
|
|
|
## daemon
|
|
|
|
Manage the background daemon.
|
|
|
|
### daemon start
|
|
|
|
```bash
|
|
sandbox-agent daemon start [OPTIONS]
|
|
```
|
|
|
|
| Option | Default | Description |
|
|
|--------|---------|-------------|
|
|
| `-H, --host <HOST>` | `127.0.0.1` | Host |
|
|
| `-p, --port <PORT>` | `2468` | Port |
|
|
| `--upgrade` | false | Use ensure-running + upgrade behavior |
|
|
|
|
```bash
|
|
sandbox-agent daemon start
|
|
sandbox-agent daemon start --upgrade
|
|
```
|
|
|
|
### daemon stop
|
|
|
|
```bash
|
|
sandbox-agent daemon stop [OPTIONS]
|
|
```
|
|
|
|
| Option | Default | Description |
|
|
|--------|---------|-------------|
|
|
| `-H, --host <HOST>` | `127.0.0.1` | Host |
|
|
| `-p, --port <PORT>` | `2468` | Port |
|
|
|
|
### daemon status
|
|
|
|
```bash
|
|
sandbox-agent daemon status [OPTIONS]
|
|
```
|
|
|
|
| Option | Default | Description |
|
|
|--------|---------|-------------|
|
|
| `-H, --host <HOST>` | `127.0.0.1` | Host |
|
|
| `-p, --port <PORT>` | `2468` | Port |
|
|
|
|
## credentials
|
|
|
|
### credentials extract
|
|
|
|
```bash
|
|
sandbox-agent credentials extract [OPTIONS]
|
|
```
|
|
|
|
| Option | Description |
|
|
|--------|-------------|
|
|
| `-a, --agent <AGENT>` | Filter by `claude`, `codex`, `opencode`, or `amp` |
|
|
| `-p, --provider <PROVIDER>` | Filter by provider |
|
|
| `-d, --home-dir <DIR>` | Override home dir |
|
|
| `--no-oauth` | Skip OAuth sources |
|
|
| `-r, --reveal` | Show full credential values |
|
|
|
|
```bash
|
|
sandbox-agent credentials extract --agent claude --reveal
|
|
```
|
|
|
|
### credentials extract-env
|
|
|
|
```bash
|
|
sandbox-agent credentials extract-env [OPTIONS]
|
|
```
|
|
|
|
| Option | Description |
|
|
|--------|-------------|
|
|
| `-e, --export` | Prefix output with `export` |
|
|
| `-d, --home-dir <DIR>` | Override home dir |
|
|
| `--no-oauth` | Skip OAuth sources |
|
|
|
|
```bash
|
|
eval "$(sandbox-agent credentials extract-env --export)"
|
|
```
|
|
|
|
## api
|
|
|
|
API subcommands for scripting.
|
|
|
|
Shared option:
|
|
|
|
| Option | Default | Description |
|
|
|--------|---------|-------------|
|
|
| `-e, --endpoint <URL>` | `http://127.0.0.1:2468` | Target server |
|
|
|
|
### api agents
|
|
|
|
```bash
|
|
sandbox-agent api agents list [--endpoint <URL>]
|
|
sandbox-agent api agents install <AGENT> [--reinstall] [--endpoint <URL>]
|
|
```
|
|
|