rebase run

Run a Rebase function, workflow, or model from local source without deploying it.

Synopsis

rebase run <file.py>::<target>
rebase run <file.py>::<target> --run-type long --param a=1 --param b=2
rebase run <file.py> --parameters-json '{"a": 1, "b": 2}'
rebase run <file.py> --no-wait
rebase run <file.py> --local

Arguments

Argument	Type	Description
`<target_ref>`	`str`	Function, workflow, or model reference. Use `file.py::target_name`, or omit `::target_name` when the file contains exactly one runnable Rebase target.

Options

Option	Type	Description
`--param`, `-p`	`name=value`	Target parameter. Values are parsed as JSON when possible. Repeat for multiple parameters.
`--parameters-json`	`json`	JSON object with target parameters.
`--run-type`	`str`	Override the run type for this ephemeral run. Accepts `quick` (default, low latency), `quick_shared` (functions and models only, shared runner), or `long` (Cloud Run Jobs for long-running work). Legacy `--backend` values such as `interactive` and `batch` are rejected.
`--module`, `-m`	`bool`	Interpret the target source as a Python module path instead of a file path.
`--wait / --no-wait`	`bool`	Wait for the result before exiting. Defaults to `--wait`.
`--timeout`	`int`	Maximum seconds to wait for the result. Defaults to `600`.
`--poll-interval`	`float`	Seconds between status polls. Defaults to `1.0`.
`--local`	`bool`	Execute the function or workflow in this Python process instead of submitting a cloud run. Workflow steps execute eagerly in-process. Models are not supported. Cannot be combined with `--run-type` or `--no-wait`.

Output

When waiting for a result, rebase run streams run progress, backend submission events, and workflow step status. Successful waited runs end with:

✓ Run completed in 1.23 seconds.

Then the command prints the JSON result.

When using --no-wait, the command prints the submitted run ID and status.

rebase run creates an ephemeral run record and sends the source for that run. It does not create or update a reusable Function, Workflow, or Model target. Use rebase deploy or rebase model deploy when you want a versioned target.

With --local, no run record is created at all: the file is imported and the function or workflow executes in the current Python process, using your local environment. This is the fast inner loop for iterating on code before submitting cloud runs. Output has the same shape as a cloud result ({} for None, dicts as-is, other values wrapped as {"value": ...}), but local execution has access to your full module globals, which packaged cloud source does not.

Use the inspection commands to look up submitted runs:

Command	Purpose
`rebase run cancel`	Cancel a submitted run.
`rebase run get`	Show run metadata.
`rebase run list`	List submitted runs.
`rebase run logs`	Show events, workflow steps, and stdout/stderr logs.

cancel

Cancel a submitted run.

Synopsis

rebase run cancel <run-id>

Arguments

Argument	Type	Description
`<run-id>`	`str`	Run ID.

Behavior

Cancels the run on its execution infrastructure and marks it cancelled. Workflow runs (quick and long) and long function/model runs are cancellable. Function and model quick and quick_shared runs execute synchronously and cannot be cancelled; the command exits with a conflict error suggesting run_type="long" for cancellable runs. See rebase run cancel for the full matrix.

get

Show run metadata.

Synopsis

rebase run get <run-id>
rebase run get <run-id> --json

Arguments

Argument	Type	Description
`<run-id>`	`str`	Run ID.

Options

Option	Type	Description
`--json`	`bool`	Print machine-readable JSON output.

Output

Shows run metadata including target type, status, run type, concrete execution backend, target IDs, backend run IDs, parameters, result, error, timings, and timestamps.

list

List submitted runs.

Synopsis

rebase run list
rebase run list --target-type workflow --limit 25
rebase run list --project default
rebase run list --json

Options

Option	Type	Description
`--project`	`str`	Filter by project name.
`--target-type`	`str`	Filter by target type. Supported values are `function`, `workflow`, and `model`.
`--limit`	`int`	Maximum number of runs to list. Defaults to `100`. Maximum is `500`.
`--json`	`bool`	Print machine-readable JSON output.

Output

The table output includes run ID, target type, status, run type, project, created timestamp, and finished timestamp.

logs

Show run events, workflow step state, and captured stdout/stderr logs.

Synopsis

rebase run logs <run-id>
rebase run logs <run-id> --no-follow
rebase run logs <run-id> --json

Arguments

Argument	Type	Description
`<run-id>`	`str`	Run ID.

Options

Option	Type	Description
`--follow / --no-follow`	`bool`	Follow until the run reaches a terminal state. Defaults to `--follow`.
`--poll-interval`	`float`	Seconds between run status polls when following. Defaults to `1.0`.
`--timeout`	`int`	Maximum seconds to follow the run. Defaults to `600`.
`--json`	`bool`	Print raw event, step, and log JSON output.

Output

Shows persisted run events, workflow step state (for workflow runs), and the run's stdout/stderr log lines. When following, new log lines stream in as they arrive. See rebase run logs for log availability per run type.

rebase run

On this page