CLI

Full-featured command-line interface for project scaffolding, code generation, database commands, deployment, and AI assistance. Built on Cobra with interactive prompts and styled terminal output.

Installation

go install github.com/CodeSyncr/nimbus/cmd/nimbus@latest
nimbus --version

Project Commands

Command	Description
`nimbus new [name]`	Create a new project with interactive wizard
`nimbus serve`	Start dev server with hot reload (Air)
`nimbus build`	Build frontend assets (CSS/JS) to public/
`nimbus repl`	Start interactive REPL session

Code Generators

All generators follow nimbus make:<type> <Name>:

Command	Creates	Location
`make:model User`	GORM model	app/models/user.go
`make:controller User`	HTTP controller	app/controllers/user.go
`make:migration create_users`	Timestamped migration	database/migrations/
`make:middleware Auth`	Middleware function	app/middleware/auth.go
`make:job SendEmail`	Queue job with Handle/Failed	app/jobs/send_email.go
`make:seeder UserSeeder`	Database seeder	database/seeders/user_seeder.go
`make:validator User`	Validation schema	app/validators/user.go
`make:command Greet`	Custom CLI command	app/commands/greet.go
`make:plugin Analytics`	Full plugin skeleton (9 files)	app/plugins/analytics/
`make:auth`	Complete auth scaffolding	model, controller, views, routes

Database Commands

Command	Description
`db:create`	Create the database
`db:migrate`	Run pending migrations
`db:rollback`	Rollback the last migration batch
`db:seed`	Run database seeders

Queue & Scheduler

Command	Description
`queue:work`	Start processing queue jobs
`schedule:run`	Start the scheduler (blocks)
`schedule:list`	List all scheduled tasks

Deploy Commands

Command	Description
`deploy`	Deploy to production (Fly.io, Railway, Render, AWS, GCP)
`deploy:init`	Initialize deployment configuration
`deploy:status`	Check deployment status
`deploy:logs`	View deployment logs
`deploy:rollback`	Rollback to previous deployment

Plugins

Command	Description
`nimbus plugin:install <name>`	Add a framework plugin (reverb, horizon, telescope, …), patch `bin/server.go`, optional `config/`
`nimbus plugin:list`	List installable plugin names

Since framework v1.0.0, the same commands are available as nested Cobra commands: nimbus plugin install <name> and nimbus plugin list.

Nimbus Cloud Authentication

Command	Description
`nimbus login`	Authenticate CLI with your Nimbus Cloud account (nimbusgo.space) via browser OAuth
`nimbus logout`	Clear saved credentials from ~/.nimbus/auth.json
`nimbus whoami`	Display logged-in account, email, and AI subscription plan

AI Copilot Workspace

Command	Description
`nimbus ai`	Claude Code CLI-style interactive multi-turn AI terminal workspace
`nimbus ai "prompt"`	Query Nimbus Cloud AI with prompt, preview/apply file changes, and continue in chat mode
`nimbus test:generate`	AI Test Generator — create unit tests from controller code (100% offline static analysis)

Running nimbus ai drops you directly into an interactive session with built-in slash commands:

Slash Command	Action
`/help`	View shortcut commands and syntax guide
`/clear`	Clear screen and reset session header banner
`/context`	Scan project models, routes, and directory structure
`/models`	Show active AI generation model
`/offline`	Toggle between Cloud synthesizer and offline rule-based generator
`/exit`	Exit interactive AI copilot session

Project Scaffolding

The nimbus new wizard prompts for project name, database driver (PostgreSQL/MySQL/SQLite), features (Auth, API, Queue, Scheduler, AI, MCP), and frontend (Tailwind/plain/none). It generates a complete project structure:

myapp/
├── main.go          # Entry point
├── go.mod           # Module definition
├── .env             # Environment variables
├── app/
│   ├── controllers/ # HTTP controllers
│   ├── models/      # GORM models
│   ├── middleware/   # Custom middleware
│   ├── validators/  # Validation schemas
│   └── jobs/        # Queue jobs
├── config/          # Configuration structs
├── database/
│   ├── migrations/  # Schema migrations
│   └── seeders/     # Data seeders
├── resources/views/ # Nimbus templates
├── public/          # Static assets
├── start/
│   ├── routes.go    # Route definitions
│   ├── kernel.go    # Bootstrap
│   ├── jobs.go      # Job registration
│   └── schedule.go  # Scheduled tasks
└── bin/
    └── server.go    # Server bootstrap