Skip to main content
The logs command prints instructions for streaming live logs from the SuperBox Cloudflare Worker. It does not stream logs directly - it outputs the wrangler tail command you should run.

​
Usage

superbox logs --name <server> [--follow|-f]

​
Options

​
--name
string
required
MCP server name. The command verifies the server exists in the R2 registry before printing instructions.
​
--follow
boolean
default:false
Changes output mode. Shorthand: -f.

​
Behavior

ModeOutput
Default (no --follow)Prints both the wrangler tail CLI command and the Cloudflare dashboard URL
With --followPrints only: wrangler tail superbox-executor --format pretty
The command verifies the server exists in R2 via s3.get_server(bucket, name) and exits with an error if not found.

​
Examples

# Get instructions for weather-server
superbox logs --name weather-server
Example output (no --follow): 
Logs for weather-server:

  CLI: wrangler tail superbox-executor --format pretty
  Dashboard: https://dash.cloudflare.com/<account>/workers/superbox-executor

# Get the follow command
superbox logs --name weather-server --follow
Example output: 
wrangler tail superbox-executor --format pretty

​
Streaming logs with wrangler

Once you have the command, run it in a terminal: 
# Stream all Worker logs
wrangler tail superbox-executor --format pretty

# Filter to errors only
wrangler tail superbox-executor --status error

# JSON output (pipe to jq)
wrangler tail superbox-executor --format json | jq .

​
Prerequisites

wrangler must be installed and authenticated: 
npm install -g wrangler
wrangler login

​
Troubleshooting

  • Server not found: Run superbox search to confirm the server name, then superbox push if it is missing.
  • wrangler: command not found: Install with npm install -g wrangler.
  • Authentication error in wrangler: Run wrangler login and complete the browser OAuth flow.