Install and Use Navi

Navi can be used in several environments. Choose the one that matches your workflow:

Environment	Best for
Longbridge App or desktop client	Using indicators and strategies directly on trading charts
Longbridge CLI	Running scripts with Longbridge market data, automation, screening, and backtests
navi CLI	Local authoring, formatting, type checking, debugging, and CI

For regular use, prefer the Longbridge App, desktop client, or Longbridge CLI. The standalone navi CLI is primarily a developer tool and does not replace the Longbridge product experience.

Longbridge App and Desktop

Use Navi inside the Longbridge App or desktop client when working interactively with charts. The Navi runtime is integrated into the product, so there is no separate Navi CLI to install.

Download Longbridge

Longbridge CLI

Use the Longbridge CLI for command-line workflows backed by Longbridge services and market data.

Install it by following the Longbridge CLI installation guide, then authenticate:

longbridge auth login

Continue to Quick Start to write a script and run it with Longbridge market data. See the longbridge quant run documentation for all command options.

Navi CLI for Development

Install the standalone navi CLI when developing or debugging .nv files locally, or when validating scripts in CI.

macOS or Linux:

curl -fsSL https://navi-lang.org/install.sh | sh

Windows PowerShell:

irm https://navi-lang.org/install.ps1 | iex

Verify the installation:

navi --version

The standalone CLI contains no market data; it provides basic compile, lint, format, and run capabilities so developers and AI agents can verify script correctness. navi run therefore requires a caller-provided OHLCV CSV through --data. The Quick Start shows how to build synthetic validation data and where to obtain real candles when needed.

VS Code Extension

The Navi VS Code extension adds syntax highlighting, diagnostics, completion, hover, go-to-definition, and formatting for .nv files. It bundles a WebAssembly language server, so it works with no separate install — including in browser VS Code (vscode.dev / github.dev).

Download the VS Code extension (.vsix)

Install it from the command line:

code --install-extension navi-vscode.vsix

Or in VS Code: open the Extensions view, use the ··· menu → Install from VSIX…, and select the downloaded file.

To use a native navi-lsp binary instead of the bundled WebAssembly server, set navi.server.mode to native and point navi.server.path at the binary.

Next Steps

• Quick Start — write and validate your first Navi script
• Language Basics — learn Navi syntax and naming conventions
• AI Assistant — install the Navi authoring skill