NOQERI / COMPILER CLI

Your toolchain field guide.

Commands here are grounded in Compiler/bootstrap/cli_host.cpp, not an imagined package manager or OS linker. The regular executable is noqeri; native web also provides noqeri-web.

← THE FULL FIELD GUIDE

01 / Everyday commands

Run the compiler without arguments for its current usage output. check supports --json diagnostics and -O0/-O1/-O2/-O3/-Os/-Oz options. run uses reference execution.

noqeri --version
noqeri new demo
noqeri check examples/hello.noqeri --json
noqeri run examples/hello.noqeri
noqeri format examples/hello.noqeri
noqeri test tests

02 / Inspect the compilation pipeline

lex prints tokens, nir emits typed intermediate representation, nqri emits portable bytecode. build emits target assembly only and does not silently assemble/link a platform executable.

noqeri lex examples/hello.noqeri
noqeri nir examples/hello.noqeri
noqeri nqri examples/hello.noqeri build/hello.nqri
noqeri build examples/native_hello.noqeri build/hello.s -O3
CURRENT CLI IMPLEMENTATION ↗

03 / Build for the web

Native static and native browser-client subset builds run through C++17. Native serve-app handles server POST actions and is loopback preview only. The more complete experimental view-project builder remains Node-hosted.

noqeri web build examples/native_web_static dist/site
noqeri web build-client examples/native_web_client dist/client
noqeri web compile examples/native_web_fullstack build/my-app
noqeri web drivers
FOUR WEB MODES ↗

04 / Graphics, databases and AI

shader targets bounded vertex/fragment/compute WGSL. db is LEGACY NoqeriDB (.nqd/.nqdb); sql delegates to external native NoeSQL selected by NOESQL_BIN. ai train/predict/agent commands and optional native AI SDK are experimental.

noqeri shader examples/shaders/vector_fragment.noqeri build/vector.wgsl --stage=fragment
noqeri db tests/noqeridb.nqd build/test.nqdb
noqeri sql --help
noqeri ai transformer train corpus.txt scratch.nqtf --steps 200
DATABASE MODES ↗AI FRAMEWORK ↗

05 / Packages and diagnostics

manifest reads project.nqon; lock produces content-addressed noqeri.lock; audit checks integrity/capabilities. targets lists target contracts, doctor and release-check inspect repository health, and lsp serves JSON-RPC. assemble/link are explicit host adapters.

noqeri manifest project.nqon
noqeri lock project.nqon
noqeri audit .
noqeri targets
noqeri doctor .
noqeri lsp
PACKAGE GUIDE ↗RELEASE GATES ↗
BUILD SOMETHING REAL WITH NOQERI.OPEN THE PLAYGROUND ↗