# `once runtime`

Runtime session inspection and control.

## Synopsis

```text
once runtime <SUBCOMMAND>
```

## Description

Starts long-lived target runs under a small supervisor and persists their stdout, stderr, and status under `<workspace>/.once/runtime/<session>/`. `runtime status`, `runtime logs`, and `runtime stop` let agents and humans observe or stop a run after the original command has returned. `runtime rpc` serves a JSON-RPC control socket for a session that already has runtime metadata.

## Subcommands

- [`once runtime start`](/reference/cli/runtime/start)
- [`once runtime status`](/reference/cli/runtime/status)
- [`once runtime logs`](/reference/cli/runtime/logs)
- [`once runtime stop`](/reference/cli/runtime/stop)
- [`once runtime rpc`](/reference/cli/runtime/rpc)

`once runtime`

Runtime session inspection and control.

Synopsis#

plaintext

once runtime <SUBCOMMAND>

Starts long-lived target runs under a small supervisor and persists their stdout, stderr, and status under <workspace>/.once/runtime/<session>/. runtime status, runtime logs, and runtime stop let agents and humans observe or stop a run after the original command has returned. runtime rpc serves a JSON-RPC control socket for a session that already has runtime metadata.

`once runtime`

Synopsis#

Description#

Subcommands#