nebutra

Governance-first CLI for Nebutra Sailor topology scaffolding, registry-backed feature installs, and platform operations.

Installation

npm install -g nebutra
# or run directly
npx nebutra

Usage

# Initialize a new project
nebutra init

# Add platform capabilities from the local registry
nebutra add cache --provider upstash-redis --yes

# Scaffold a topology-first app with the create-sailor flag surface
nebutra create ./my-app --region=hybrid --ai=openai,deepseek

# Start dev server
nebutra dev --preset=ai-saas

# Database migrations
nebutra db migrate

# Generate a new app or module
nebutra generate app blog

# Brand customization
nebutra brand palette --primary=#0047FF

# Project health check
nebutra doctor

Commands

| Command | Description | |---------|-------------| | init | Initialize project with nebutra.config.json | | add [components...] | Add registry-backed platform features or external UI components (--21st, --v0) | | create | Scaffold a topology-first Nebutra Sailor project through create-sailor | | mcp | Start the MCP server for AI agents and editors | | dev | Start development server | | generate | Scaffold apps, modules, and code | | db | Database migration and management | | brand | Color palette and brand customization | | i18n | Internationalization management | | infra | Infrastructure management (Docker, services) | | env | Environment variable management | | license | License activation and management | | ai | AI provider and gateway routing configuration | | auth | Authentication setup | | billing | Billing and subscription management | | preset | List and apply SaaS presets | | test | Run unit/E2E tests | | stats | Monorepo overview and metrics | | schema | Output full CLI schema (for agents) | | doctor | Check project health | | admin | Platform administration (tenants, health) | | community | Community health and showcase | | ecosystem | Template marketplace, ideas, showcase, and sync workflows | | services | Microservice management | | search | Search index management | | secrets | Encrypted secrets management | | completions | Generate shell completions for the current command surface |

Global Options

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

Environment Variables

| Variable | Description | |----------|-------------| | NEBUTRA_LOG_LEVEL | Log level (debug, info, warn, error) | | NEBUTRA_OUTPUT_FORMAT | Default output format | | NO_COLOR | Disable colored output | | CI | Auto-enable non-interactive mode |

Agent Schema

nebutra schema create
nebutra schema add
nebutra schema --all

schema create exposes the current create-sailor value domains, including region, auth, AI, storage, cache, webhooks, CMS, captcha, metering, and MCP options. schema add exposes local registry features such as queue, search, cache, notifications, webhooks, cms, feature-flags, and captcha.