CLI Overview

Nebutra ships three command-line tools, each with a distinct purpose.

create-sailor

Bootstrap a new project with an interactive wizard. Run once per project.

nebutra CLI

Day-to-day development: scaffold code, manage infra, run tests, and more.

pnpm scripts

Turborepo-orchestrated scripts for build, lint, test, and deployment.

Quick install

# Scaffold a new project (run once) — published as [email protected]+
npx create-sailor@latest my-saas-app

# Install the Nebutra CLI globally (optional — also available via pnpm exec)
# Published as [email protected]+
npm install -g nebutra@latest

# Or use directly inside the monorepo
pnpm exec nebutra --help

When to use which tool

Task	Tool
Create a new project from scratch	`npx create-sailor`
Scaffold an app, package, or component	`nebutra generate`
Manage Docker infrastructure	`nebutra infra`
Run database migrations	`nebutra db migrate`
Validate environment variables	`nebutra env validate`
Add a component from 21st.dev or v0.dev	`nebutra add`
Build, lint, typecheck, test	`pnpm build / lint / typecheck / test`
Start a dev server	`pnpm dev` or `nebutra dev`
Release packages with changesets	`pnpm release`

Global flags

All nebutra subcommands accept these flags:

Flag	Description
`--verbose`	Enable verbose output
`--quiet`	Suppress non-essential output
`--format <type>`	Output format: `json`, `table`, `plain`
`--yes`	Skip all interactive prompts (Agent / CI mode)
`--no-interactive`	Alias for `--yes`
`--no-color`	Disable colored output

Exit codes

Code	Meaning
`0`	Success
`1`	General error
`2`	Invalid arguments
`3`	Resource not found
`4`	Permission denied
`5`	Conflict / already exists
`6`	Network error (retryable)
`10`	Dry-run OK (no changes made)

Environment variables

Variable	Values	Description
`NEBUTRA_LOG_LEVEL`	`debug\|info\|warn\|error`	CLI log verbosity
`NEBUTRA_OUTPUT_FORMAT`	`json\|table\|plain`	Default output format
`NO_COLOR`	any	Disable colored output
`CI`	any	Auto-enable non-interactive mode

MCP server

Nebutra ships an MCP (Model Context Protocol) server for AI coding tools (Cursor, Windsurf, Claude Code). Run via nebutra mcp inside the monorepo, or globally:

npx nebutra-mcp