tool

Neutron CLI

One 20 MB Go binary that handles scaffolding, dev servers, migrations, code generation, Nucleus, Studio, native and desktop workflows, and MCP.

One binary. Sixteen commands. Every language.

Available

16Top-Level Commands

20 MBSingle Binary

GoCross-Compiled

0Dependencies

Install once. Run anything.

A single neutron binary handles every SDK in the ecosystem. It detects the project language from its standard manifest and delegates development to the appropriate toolchain. It also manages Nucleus, migrations, Studio, generated database types, native and desktop workflows, and MCP.

terminal
$ neutron new my-app --lang typescript # scaffold a project
$ neutron dev                          # HMR dev server
$ neutron migrate                      # apply pending migrations
$ neutron migrate down                 # roll back one migration
$ neutron generate --table users --lang ts

$ neutron db start                     # start local Nucleus
$ neutron db reset                     # wipe and recreate the database
$ neutron studio                       # standalone Studio server
$ neutron mcp                          # MCP server over stdio

$ neutron desktop dev                # Tauri desktop dev
$ neutron native run ios             # build + run on iOS sim
$ neutron native run android         # build + run on Android emulator

Scaffold

neutron new scaffolds TypeScript, Python, Go, Rust, Zig, and Julia projects with native manifests and starter source.

Dev server

Vite-backed HMR for TypeScript, cargo-watch for Rust, air for Go, uvicorn --reload for Python. Same neutron dev in each.

Migrations

Generate, apply, and roll back schema changes across all 14 Nucleus models. Up/down files, SQL or TypeScript.

Typed generation

neutron generate reads database tables and emits typed Go, TypeScript, Rust, Python, Elixir, or Zig models.

Studio launcher

neutron studio boots the visual database manager against your local Nucleus. Browse all 14 data models; no install step.

MCP server

neutron mcp exposes 19 tools over stdio or HTTP — database ops plus docs search. OpenAI-compatible, --dump-schema for AI context priming.

Built in Go for a reason.

One static binary, cross-compiled to every OS and arch we support. No Node runtime to bring. No Python interpreter to pin. Install with a single curl, or grab a release from GitHub. The CLI is the same size and shape on Linux, macOS, Windows, and ARM — and it's how your CI servers will talk to Neutron too.

install
# Download a prebuilt archive from GitHub Releases, or build from source:
git clone https://github.com/neutron-build/neutron.git
cd neutron/cli
make install

# TypeScript projects use the separate framework CLI:
npm install -D @neutron-build/cli
npx neutron-ts --help

What it's for

Every day of working with Neutron. Local dev, CI pipelines, deploy scripts, one-off migrations, Studio sessions, MCP integrations with Claude or ChatGPT. If it's Neutron-shaped, it runs through neutron.

Why one CLI?

Because a language-agnostic ecosystem needs a language-agnostic front door. If every SDK had its own CLI you'd be memorizing seven sets of flags; instead, the Go binary delegates to whatever the underlying language expects, and you only learn one surface.

Part of a bigger system

The CLI knows about every other Neutron component: it can scaffold a Rust service that talks to a Nucleus cluster via neutron-nucleus, spin up Studio against it, and deploy both through the same build pipeline. One tool for the whole stack.

Start building with Neutron

Read the docs →View source