Build the CLI

Package a native Noumena Code binary outside the monorepo.

Supported toolchain

Bun 1.3.14 or newer
Rust 1.80 or newer, with cargo on PATH
curl or wget for optional installation helpers

You do not need the Noumena monorepo or Buck2 to build the public CLI.

Build from the public source tree

From a clean checkout of the public CLI repository:

git clone https://github.com/Noumena-Network/code.git
cd code
bun install
bun run build

The build produces dist/cli.js and compiles the native Markdown renderer, OpenAI-compatible WebSocket transport, and local supervisor peer-validation modules. Verify the development launcher before installing it:

./ncode --version
./ncode --help

Package the supported native target

The public packager supports bun-linux-x64, the Linux x64 glibc target:

bun build/package.mjs --target bun-linux-x64

Use the binaryPath, manifestPath, and zipPath printed by the packager rather than assuming a versioned output directory.

Install the launcher

After verification, install the launcher and shell integration:

./ncode install
ncode --version

Run the installed command from a project directory and continue with the CLI quickstart.

Source note

This page is adapted from the public Noumena-Network/code OSS build guide, licensed under Apache-2.0.