[bldr]docs
CLI toolsbldr

bldr run

Run an application built by bldr: `bldr run <TARGET>:<RUNNABLE>` starts a runnable (backed by a build) and streams its progress + pod logs

bldr run

Run an application built by bldr: bldr run &lt;TARGET>:&lt;RUNNABLE> starts a runnable (backed by a build) and streams its progress + pod logs

bldr [BLDR FLAGS] run [RUN FLAGS] <TARGET>

<TARGET>

A Runnable CID, or the name of a ref holding one.

To run something this workspace builds, build it: bldr build &lt;target> --run &lt;target>.

Required.

-p, --publish <HOST:POD[/udp]>

Publish a host→service port (repeatable), overriding/adding to the runnable's declared ports. E.g. -p 1234:1234

May be given more than once.

--name <NAME>

Name this run, so it is identifiable in bldr runs and the console instead of showing the runnable's CID. Travels as the label bldr.name=&lt;NAME>

--label <KEY=VALUE>

Attach a label KEY=VALUE to the run (repeatable). --name is the shorthand for --label bldr.name=…

May be given more than once.

-d, --detach

Start the run in the background and return immediately (reattach with bldr runs watch &lt;id>). Without this, the run is foreground — Ctrl-C stops it

Defaults to false.

--output <OUTPUT>

Output format for the event stream

Defaults to pretty.

Value
prettyLive tree view with spinners and progress bars (default)
jsonOne JSON object per line, printed as each event arrives
ronOne Rust Debug ({:#?}) block per line, printed as each event arrives

On this page