Get started

REPL

Run buzz without arguments to start the REPL:

buzz

The REPL is useful for quick experiments. It imports buzz:std and buzz:debug automatically, keeps successful declarations between submissions, and prints the value of expressions:

>>> 1 + 2
3
>>> final name = "buzz";
>>> std\print("hello {name}");
hello buzz

If you are building buzz from source, use zig build run to start the same REPL from the build tree.

Standalone scripts

Pass a script path to run a single script file:

buzz <script>.buzz

Any arguments after the script path are passed to the script's main function:

buzz hello.buzz Alice

Package

Use buzz init to create a minimal package in the current directory:

buzz init

The command asks for package metadata, then writes manifest.buzz, build.zig, src/main.buzz, a small library example, and a vendors/<package-name> link back to the package. After that, run:

buzz .

buzz <directory> expects the directory to be a buzz package with a manifest.buzz file. It executes src/main.buzz from that package and passes any extra command-line arguments to that script.