NoumenaDocs
/
Documentation
Start here
Noumena Code documentationGetting started
Web app
Repositories and source browsingCode browser and historySearch
Workflows
Issue-driven workStack reviewsScoped workspacesCloud sessions
Source control
Source control in Noumena CodeJJ and SmartlogSapling and stacksGit and GitHub-compatible workflows
Account
Organizations, members, and teamsProfile and developer accessUsage and billing
CLI
CLI quickstartBuild the CLIAuthenticate the CLIConfigure models and endpointsCLI reference
Security
Security and safe operation
Reference
Compatibility and product boundariesTroubleshooting

CLI quickstart

Install Noumena Code, connect your account, and start a session from a repository.

Install NCode

The supported public installation path builds the CLI from the public source repository. It requires Bun 1.3.14 or newer and Rust 1.80 or newer. Follow Build the CLI, run ./ncode install, and verify the installed command before connecting an account:

ncode --version
ncode --help

The source build produces dist/cli.js; ./ncode install installs the launcher and shell integration.

Sign in

Noumena-managed accounts use the browser OAuth flow:

ncode auth login

If the browser does not open, follow the URL printed by the CLI. You can also start ncode and enter /login inside the REPL. See Authenticate the CLI for automation and BYOK options.

Start from your repository

Run NCode from the repository you want it to understand:

cd /path/to/your/project
ncode

Before approving tools, confirm that the displayed workspace root and repository are the ones you intended. Keep the first task small enough that you can review every command and file change.

Learn the core controls

Inside the REPL:

/help
/model
/status

Read CLI reference for the complete command surface, then choose a source-control workflow: Git, Sapling, or JJ.

Source note

This guide is adapted from the public Noumena-Network/code README and OSS build guide.