Skip to content
Regents Regents Corpus

Runtime Commands

Status: beta.

Regents CLI has two runtime lanes. One lane is local and helps agents work from a machine. The other lane is Platform-backed and controls hosted Regent runtimes.

Local Runtime Checks

Section titled “Local Runtime Checks”

Use these beside regents run:

Terminal window
regents runtime status --json
regents runtime tools --json
regents runtime policy --json

These commands help scripts and agents understand whether the local runtime is available, which tools are exposed, and what policy applies to local work.

Hosted Regent Runtime Commands

Section titled “Hosted Regent Runtime Commands”

Use these when operating a hosted Regent runtime:

Terminal window
regents runtime --help
regents agent chat --help

Use the App when a person needs to review billing, hosted workspace controls, or Regent readiness.

Use regents agent chat when you want one hosted Regent reply from the terminal. Add --timeout-seconds <5-60> when the answer may take longer.

Hosted runtime views include Sprite state, Hermes state, voice gateway state, and checkpoint state. The CLI includes runtime checkpoint and restore commands where the hosted runtime supports them.

Practical Rule

Section titled “Practical Rule”

Use local runtime commands when the question is “is this machine ready?”

Use hosted runtime commands when the question is “what is happening to this hosted Regent?”

Use regents agent chat when the question is “what does this hosted Regent say right now?”

Next

Section titled “Next”