CLI toolsbldr
bldr
Builder node gRPC client
Builder node gRPC client
Generated from bldr 0.1.0.
bldr [BLDR FLAGS] <COMMAND>Commands
| Command | |
|---|---|
bldr blob | Blob operations |
bldr build | Create a build and watch it live until it finishes |
bldr builds | Manage builds — list, inspect, attach, detach, delete, or create a detachable build |
bldr cache | Function-invocation cache operations |
bldr cluster | Distributed-pinning cluster state (members, pins, refs, GC epoch) |
bldr completions | Shell completions: print a script, or wire them into your shells |
bldr deploy | Run a deployment: invoke a Deployment block (function + options) by CID and stream its progress tree. See bldr deployments to list runs |
bldr deployments | Manage deployment runs — list (optionally live), inspect, abort, delete |
bldr fetch | Recursively download a DAG from the peer network into the node's local store |
bldr fs | Filesystem tree operations: import, materialise, and FUSE mount |
bldr get | Fetch a single block from the node (local-first, optional network fallback) |
bldr info | Show node identity, addresses, peer count, and bootstrap status |
bldr inspect | Inspect a CID: detect its kind (blob / fs-node / container-image / dag-cbor) and print a typed summary. Child CIDs (directory entries, image layers) are shown so you can drill in with another inspect |
bldr invoke | Invoke a registered function over the function protocol |
bldr login | Log in to bldr-service, the hosted bldr console |
bldr logout | Log out of bldr-service: revoke this CLI's login and forget it |
bldr logs | Read content-addressed log streams by full id {peer}/{tenant}/{uuid} |
bldr map | The persistent key → CID map: TTL'd, pinnable, GC-rooted mappings (sealed log streams live here as log/{stream-id}) |
bldr net | Network and peer management |
bldr peers | List connected peers (or watch live events with --watch / -w) |
bldr pod | Pods: docker/podman-style container sandboxes for testing images (CID in, stdout/stderr + a diff CID out). Not the way to build things |
bldr put | Store data in the node's local block store |
bldr ref | Manage named CID refs on the remote node |
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 runs | Manage runs — list (optionally live), attach, stop |
bldr secret | Manage secrets stored in the node's secret provider |
bldr storage | The block store: what holds its bytes, and garbage collection |
bldr test | Build a workspace (or a member) and report its test results: every ctx.addTest(name, …) target is built, then the daemon's aggregated per-case verdict is printed. Exits non-zero if any case failed |
bldr wait-for | Block until a resource reaches a state, then say what happened and how long it took |
bldr whoami | Show who this CLI is logged in to bldr-service as |
bldr workspace | Manage workspaces — directories containing bldr-workspace.yml |
Global flags
Accepted by every command above.
-s, --server <SERVER>
gRPC server address.
Unix: unix:///run/user/<uid>/bldr.sock (default, from $XDG_RUNTIME_DIR) TCP: http://host:port
Defaults to unix://$XDG_RUNTIME_DIR/bldr.sock.
--output-format <FORMAT>
How to render build event streams.
pretty (default): live tree view (Ctrl-C abort, Ctrl-X detach). json: print each raw BuildEvent as a JSON object on its own line. ron: print each raw BuildEvent in Rust Debug format (one per line).
Defaults to pretty.
| Value | |
|---|---|
pretty | Live tree view with spinners and progress bars (default) |
json | One JSON object per line, printed as each event arrives |
ron | One Rust Debug ({:#?}) block per line, printed as each event arrives |
--tenant-id <ID>
Scope this request to a tenant.
Sends x-bldr-tenant-id: <id> so the daemon addresses content in tenant <id>'s namespace. Omitted ⇒ the default tenant (0).