# `once run`

Run a declared target.

## Synopsis

```text
once run [OPTIONS] [TARGET] [ARG]
```

## Description

Resolves the target id against the workspace graph and executes its `run` capability through the action cache. Use `--remote` to ask a compute provider to execute the command.

## Arguments

| Argument | Required | Description |
| --- | --- | --- |
| `<TARGET>` | no | Target id, e.g. `examples/hello/hello` or `./hello`. |
| `<ARG>` | no | Target-kind-specific arguments supplied to the generic run capability. |

## Options

| Flag | Value | Default | Description |
| --- | --- | --- | --- |
| `--sandbox` | `<SANDBOX>` | `off` | Local filesystem sandbox policy for command actions. |
| `--config` | `<KEY=VALUE>` |  | Override the workspace build configuration. See `once build --config`. |
| `--visible` | (flag) |  | Ask graph target kinds to open a visible runtime interface when supported. |
| `--runtime-rpc` | (flag) |  | Serve a local JSON-RPC runtime control socket for this run. |
| `--runtime-rpc-socket` | `<RUNTIME_RPC_SOCKET>` |  | Runtime RPC socket path. Defaults to `.once/runtime/<session>/control.sock`. |
| `--remote` | (flag) |  | Run the target's action on a compute provider. |
| `--compute` | `<PROVIDER>` |  | Compute provider used with --remote. Defaults to the configured execution provider. |