Skip to content
All guides

learn

Scripting (optional)

Native AOT is the default: buraaq run / buraaq build → LLVM → binary. No GC.

For a terminal loop, buraaq, -e, and script wrap a snippet in fn main and compile it with clang. Same language as AOT. Not a second dialect, and not a clang-free MIR interpreter.

Check install

buraaq --version
buraaq doctor

doctor reports clang (required for the shell as well as native builds) and a scripting line.

Interactive shell

buraaq
# or: buraaq shell   /   buraaq repl
buraaq 1.0.0 shell
bq> println("hi")
bq> 1 + 2 * 3
6
bq> :quit

One-liner / file

buraaq -e "println(40+2)"
buraaq script path.bq
#!/usr/bin/env -S buraaq script

fn main() {
    println("hello from buraaq script")
}
CommandRole
buraaq / shell / replInteractive shell (clang per line)
buraaq -eEval a snippet
buraaq scriptRun a .bq file
buraaq runNative AOT binary (product path)

Clang is required for run / build / flash and for the shell / -e / script.

Next: electronics for boards, or install.