CLI command reference

Arguments can be expanded from response files using the @file convention (via the argfile crate), consistent with other Rust CLI tools.

Unless noted, failures print a diagnostic report (miette) and exit non-zero.

Global behavior

• On launch, the CLI ensures the bundled corelib tree is available (and may print a short message when it materializes or updates a copy). Override the source location with BESKID_CORELIB_SOURCE when developing against a different corelib checkout.
• Subcommands that need a single resolved .bd entrypoint accept optional --project, --target, and --workspace-member together with --frozen / --locked where project resolution applies (see analyze, doc, run, build, clif, fetch).

Commands

Command	Summary
parse	Parse a .bd file and print a debug AST view
tree	Print a textual AST tree
analyze	Run semantic analysis and print diagnostics
format / fmt	Pretty-print sources (file or recursive directory)
doc	Emit api.json and index.md for API docs
clif	Lower to CLIF and print IR
run	JIT-compile and execute
test	Discover, filter, and run test items
build	AOT compile and link
fetch	Resolve and materialize dependencies
lock	Synchronize Project.lock
update	Update resolution and materialized workspace
corelib	Materialize embedded corelib template
new	List, install, and instantiate project/workspace/item templates
pckg	pckg registry client: pack (.bpk), upload (registry-assigned version), search, download, yank, …