RunTools CLI

Command-line access to RunTools sandboxes, agents, workspaces, model choices, RunMesh devices, activity, tools, credentials, and code execution.

npm install -g @runtools-ai/cli
runtools login
runtools sandbox create --name dev
runtools models list
runtools workspaces list

Core Commands

• runtools login / runtools logout manage local auth.
• runtools sandbox ... creates, lists, resumes, pauses, watches, executes commands in, and deletes sandboxes.
• runtools agent ... deploys and runs agents.
• runtools models list shows the public Platform and BYOK model choices. Platform routing is abstracted behind RunTools; BYOK entries only enable when the matching credential exists.
• runtools workspaces ... lists, creates, updates, inspects usage for, and deletes workspaces.
• runtools activity list shows customer-facing activity events with resource filters.
• runtools devices ... manages RunMesh devices and sandbox peers.
• runtools threads ... inspects, tails, archives, compacts, and deletes cloud thread history.
• runtools tool ... searches, installs, executes, and manages marketplace/custom tools.
• runtools secret ... stores and manages encrypted user/org credentials.
• runtools execute ... runs short code snippets in the platform code-execution service.

Auth

The CLI uses the same RunTools API as the dashboard and SDK. Sign in interactively with:

runtools login

For automation, set a RunTools API key with:

runtools auth set-key <rt_...>