Early preview: syntax, standard library APIs, and tooling may change.

FoundationsBlorp CLI

Blorp CLI

blorp is the command line surface for checking, running, testing, formatting, compiling, and inspecting programs.

Run

blorp run compiles and executes one file. Put program arguments after -- so they are passed to your main function.

terminal
blorp run hello.brp
blorp run greet.brp -- Ada Lovelace
blorp run --release app.brp

Check

blorp check parses, imports, and type checks a file or every .brp file in a directory without running the program.

terminal
blorp check program.brp
blorp check src/
blorp check --no-format src/

Test

blorp test runs test files or directories. Use --doc or --suite when you want only doctests or only TestSuite tests.

terminal
blorp test tests/
blorp test --doc std/string.brp
blorp test --suite tests/
blorp test -j 8 --timeout 30 tests/

Format

blorp format rewrites source in place. Use --check in CI when formatting should be verified without modifying files.

terminal
blorp format file.brp
blorp format --check file.brp

Compile and Inspect

blorp compile emits generated C. The inspection flags expose parser, type, and compiler pipeline output for debugging.

terminal
blorp compile program.brp
blorp compile -o program.c program.brp
blorp compile --ast program.brp
blorp compile --time-phases program.brp

Debugging Flags

Use runtime and compiler flags when you need debug-only code, sanitizer coverage, leak checks, or a specific standard library checkout.

terminal
blorp run --debug program.brp
blorp run --sanitize program.brp
BLORP_LEAK_CHECK=1 blorp run program.brp
BLORP_STD=std blorp check src/

Editor and REPL

blorp lsp serves editor integrations, blorp repl starts an interactive session, and blorp purify helps mark pure functions.

terminal
blorp lsp
blorp repl
blorp purify src/main.brp