CLI Reference

CLI Command Reference

Every command available in the jungle CLI — grouped by area with flags, descriptions, and copyable examples.

Start with npxnpx @jungle-grid/cli@latest loginNode.js 18+

Auth

Auth commands

Authenticate the CLI against your Jungle Grid account using the browser-backed device flow.

jungle login

Open a browser window to authenticate this machine. On completion the CLI stores a session token locally.

Show flags, examples, and notes

Flags

FlagDescription

--no-browser

Print the device URL instead of opening it automatically.

Examples

jungle login

jungle login --no-browser

If your team points at a non-default orchestrator, set JUNGLE_GRID_API before running login so the CLI stores the correct environment.

jungle whoami

Print the currently authenticated account email and session metadata.

Show flags, examples, and notes

Examples

jungle whoami

jungle logout

Revoke the local session token and sign out of this machine.

Show flags, examples, and notes

Examples

jungle logout

Submit

Submit commands

Queue workloads by intent. The orchestrator resolves placement — you describe what you want to run, not which GPU to use.

jungle submit

Submit a workload. The CLI fetches a cost estimate first and asks for confirmation before queuing.

Show flags, examples, and notes

Flags

FlagDescription

--workload <type>

Workload class: inference | batch | trainingrequired

--image <ref>

Container image referencerequired

--model-size <B>

Approximate model size in billions of params

--name <name>

Human-readable job label

--command <cmd>

Override container entrypoint command

--arg <arg>

Argument passed to --command (repeatable)

--optimize-for <hint>

Placement hint: cost | speed

--max-price-hour <usd>

Optional max hourly price ceiling for this job

--prefer-family <family>

Optional preferred GPU family without exact model selection

--avoid-family <family>

Optional GPU family to avoid (repeatable)

--region <slug>

Optional region preference such as us-east

--latency-priority <level>

Latency weight override: low | balanced | high

--cost-priority <level>

Cost weight override: low | balanced | high

--registry-credential <id>

Saved credential ID for private images

--yes-y

Skip the estimate confirmation prompt

Examples

jungle submit \
  --workload inference \
  --model-size 7 \
  --image ghcr.io/acme/infer:latest \
  --name chat-infer

jungle submit \
  --workload batch \
  --model-size 3 \
  --image node:22-alpine \
  --command node --arg app.js \
  --optimize-for cost

jungle submit \
  --workload training \
  --model-size 40 \
  --image pytorch/pytorch:2.4.0-cuda12.1-cudnn9-runtime \
  --command python --arg train.py \
  --optimize-for speed

jungle submit \
  --workload inference \
  --image registry.example.com/mymodel:v2 \
  --registry-credential cred_abc123

jungle submit \
  --workload inference \
  --model-size 13 \
  --image ghcr.io/acme/infer:latest \
  --max-price-hour 2.50 \
  --prefer-family l4 \
  --avoid-family a100 \
  --region us-east \
  --latency-priority high \
  --cost-priority balanced

The submit estimate now shows likely placement, hourly rate, total cost range, queue wait range, estimated start window, and any soft constraints that were auto-relaxed.

Jobs

Jobs commands

Inspect running and completed workloads. Find job IDs, review lifecycle state, and tail runtime logs.

jungle jobs

List all jobs on your account with their current status.

Show flags, examples, and notes

Examples

jungle jobs

jungle status <job-id>

Show the detail view for a single job — the same data the portal status page uses.

Show flags, examples, and notes

Examples

jungle status job_1a2b3c4d

jungle logs <job-id>

Tail the runtime output for a job. Useful once you already know which job you want to inspect.

Show flags, examples, and notes

Flags

FlagDescription

--follow-f

Stream new log lines as they arrive.

--tail <n>

Number of recent lines to show at start (default 100).

Examples

jungle logs job_1a2b3c4d

jungle logs job_1a2b3c4d --follow

jungle logs job_1a2b3c4d --tail 50

Nodes

Nodes commands

Browse public capacity, register a provider node, and manage the local node-agent daemon.

jungle nodes

List public capacity currently available in the marketplace.

Show flags, examples, and notes

Flags

FlagDescription

--workload <type>

Filter nodes by supported workload class.

Examples

jungle nodes

jungle nodes --workload inference

jungle nodes show <node-id>

Show the detail view for a single node including capacity signals.

Show flags, examples, and notes

Examples

jungle nodes show node_xyz789

jungle node register

Show flags, examples, and notes

Flags

FlagDescription

--dispatch-url <url>

Local dispatch endpoint for the node agent.required

--location <region>

Geographic label for this node (e.g. lagos, london).

Examples

jungle node register \
  --dispatch-url http://127.0.0.1:8090 \
  --location lagos

jungle node install-agent

Download and install the managed node-agent binary. Most providers can skip this — jungle node start installs on demand.

Show flags, examples, and notes

Examples

jungle node install-agent

jungle node start / stop / status

Start the node-agent in the background as a daemon, stop it, or check its current state.

Show flags, examples, and notes

Flags

FlagDescription

--daemon

Run the agent as a background daemon (start only).

Examples

jungle node start --daemon

jungle node status

jungle node stop

Credentials

Credentials commands

Save private container registry credentials so you can submit private images without pasting secrets into every command.

jungle registry-credentials list

List all saved registry credentials on your account.

Show flags, examples, and notes

Examples

jungle registry-credentials list

jungle registry-credentials create

Interactively save a new registry credential. The CLI prompts for the registry host, username, and access token.

Show flags, examples, and notes

Examples

jungle registry-credentials create

jungle registry-credentials show <id>

Show the metadata for a saved credential (secrets are never echoed).

Show flags, examples, and notes

Examples

jungle registry-credentials show cred_abc123

jungle registry-credentials delete <id>

Permanently delete a saved registry credential.

Show flags, examples, and notes

Examples

jungle registry-credentials delete cred_abc123

Deleting a credential that is referenced by a running job will not interrupt that job, but future submits using the same --registry-credential flag will fail.