Skip to content

Run compute Jobs on Nodus

nodus submits and manages Nodus resources: Jobs, Sandboxes, Functions, Agents and more.

--context string Context from the config file to use
-h, --help help for nodus
--org string Organization (selects the context for that org)
-p, --project string Project to work in
-v, --verbose Log each API request (never credentials)
  • nodus agentrun - Message an AgentRun and read its steps and answer
  • nodus annotate - Set or remove annotations
  • nodus api-resources - List the kinds the server offers
  • nodus apply - Create or update resources from manifests (client-side three-way merge)
  • nodus attach - Attach to a running Process of a Job, Sandbox or Workspace
  • nodus auth - Credentials for other tools, and permission checks
  • nodus billing - Show the org’s balance; top up, redeem a code and manage auto-recharge
  • nodus cancel - Cancel a run, FunctionCall or Process
  • nodus cloud - Inspect connected cloud accounts
  • nodus completion - Generate the autocompletion script for the specified shell
  • nodus config - Show and change contexts in ~/.nodus/config
  • nodus convert - Turn a 0.x nodus.toml or training file into manifests for nodus apply
  • nodus cp - Copy files to and from a running Sandbox, Workspace or Job, or download a Job output
  • nodus create - Create resources from manifests or with a typed generator
  • nodus delete - Delete resources
  • nodus deploy - Deploy the nodus.App in APP.py as a persistent App
  • nodus describe - Show everything about one resource: attempts, placement, checkpoint, cost, conditions and events
  • nodus diff - Show what apply would change, from a server dry-run (exit 1 when there are differences)
  • nodus edit - Edit a resource in $EDITOR and save it as a merge patch
  • nodus events - List events in the project, or for one object, and watch for new ones
  • nodus exec - Run a command in a running Job, Sandbox or Workspace (recorded as a Process)
  • nodus explain - Show the documentation of a kind or one of its fields
  • nodus get - List or show resources
  • nodus inference - Call hosted models: list them, send a chat completion and read a request’s receipt
  • nodus init - Scaffold a manifest or app.py in the current directory
  • nodus label - Set or remove labels
  • nodus login - Sign in through the console and store one API key per chosen org
  • nodus logout - Revoke the context’s CLI key and remove the context
  • nodus logs - Print or follow a resource’s output
  • nodus mcp - Serve Nodus tools to a local MCP client over stdio
  • nodus open - Open a resource’s console page, or a port of its container, in the browser
  • nodus patch - Update fields of a resource with a merge or JSON patch
  • nodus pool - Pool utilization, forecasts, recommendations and actions
  • nodus port-forward - Forward local ports to a Job, Sandbox or Workspace
  • nodus request - Request an action: restart, refresh-secrets, reload-sinks, verify, resend, start, reimport, approve-burst, drain
  • nodus resume - Resume a suspended run
  • nodus rollout - Roll out changes
  • nodus run - Run a command as a Job: estimate, phases, logs and the final cost
  • nodus secret - Create Secrets from literals, env files or registry logins
  • nodus serve - Run the App in APP.py and redeploy it whenever a file changes
  • nodus shell - Open an interactive shell in a Sandbox, creating it if it is not there
  • nodus ssh - Connect to a Workspace over SSH
  • nodus start - Start a stopped Sandbox, Workspace, Function, Agent or InferenceEndpoint
  • nodus stop - Stop a Sandbox, Workspace, Function, Agent or InferenceEndpoint
  • nodus suspend - Suspend a Job, Pipeline, Sweep, TrainingJob or AgentRun (checkpointing first)
  • nodus top - Show GPU, CPU and memory use, the hourly rate and spend of running Jobs
  • nodus version - Print the client version
  • nodus volume - Put, get, list and remove the files of a Volume
  • nodus wait - Wait until a resource meets a condition
  • nodus whoami - Show the signed-in principal, org, role, project, scopes and available credit