Documentation

The orb CLI

Every orb command: validate, verify, compile, serve, and the tools around them.

orb (also installed as orbital) is one native binary. Install it from the installation page.

Check

bash
1 2 3 4 5 6 orb validate app.lolo # 0 errors and 0 warnings is the bar orb validate app.lolo --json # findings with codes and source positions orb verify app.lolo # play every transition in the Rust kernel orb verify app.lolo --trait Checkout # one trait at a time orb verify app.lolo --all # the Rust kernel, the JS runtime and the compiled app orb test app.lolo # exhaustive state-machine tests

Build and run

bash
1 2 3 4 5 orb serve app.lolo --open # compile and serve with the bundled runtime orb compile app.lolo --output ./out # write a full TypeScript app orb compile app.lolo --mode client # client only: a static site for browser-stored data orb compile app.lolo --shell python # other backends: python, rust, mobile, android, ios orb new my-app # scaffold a project

Inspect

bash
1 2 3 4 5 6 orb emit orb app.lolo # the lowered .orb JSON orb resolve app.lolo --output app.orb # every import flattened orb emit ts app.lolo --section Checkout # generated code for one part orb execute app.lolo --event PAY --payload '{"amount": 40}' orb format app.lolo # pretty-print in place orb evaluate '(math/clamp 12 0 10)' # evaluate an expression

Behaviors and engines

bash
1 2 3 4 orb list --global # installed orb packages, and whether each loads orb add <package> # add one to a project orb engines install --global # the verify engines for --runtime / --compiled orb signatures --out signatures.lolo # the type catalog agents read

Agent

bash
1 2 3 orb "Build a booking system for a small clinic" orb --last "Add a cancellation fee" orb fix app.lolo

Editor integration

bash
1 2 orb complete app.lolo --offset 512 # what may be written at a cursor, as JSON orb embeds app.lolo # where each inline behavior embed sits

Exit codes: 0 means everything requested passed, 1 means a check failed, and 2 means a tool could not run.

Orb

The language where the rule is the program.

© 2026 Almadar. Ljubljana, Slovenia.
Reporting this visit…