CLI

The mbc-cqrs-serverless CLI helps you quickly scaffold new projects and generate boilerplate code for modules, services, and entities. It follows the framework's conventions to ensure consistency.

When to Use the CLI

Use the CLI when you need to:

• Create a new MBC CQRS Serverless project from scratch
• Add a new domain module (product, order, user)
• Generate controller, service, entity, and DTO files with correct structure
• Start the local development server

Problems the CLI Solves

Problem	Solution
Setting up project structure manually is error-prone	mbc new creates complete project skeleton
Remembering correct file names and imports	mbc generate creates consistent boilerplate
Forgetting to register modules correctly	Generated code follows NestJS conventions

Installation

To install the CLI globally:

npm install -g @mbc-cqrs-serverless/cli

Available Commands

To get a list of the available CLI commands, run the following command:

mbc -h

The output should look like this:

Usage: mbc [options] [command]

Options:
  -V, --version           output the version number
  -h, --help              display help for command

Commands:
  new|n [name]            Generate a new CQRS application using the MBC CQRS
                          serverless framework
  generate|g <schematic>  Generate a MBC-cqrs-serverless element
  start|s                 Start application with serverless framework
  ui-common|ui [options]  add mbc-cqrs-ui-common components to your project
  help [command]          display help for command

new Command

Use Case: Start a New Backend Project

Scenario: You're starting a new microservice or API backend and need the complete project structure with all dependencies.

mbc new [projectName[@version]]

Examples

Create a new project in the current directory:

mbc new

Create a project with a specific name:

mbc new my-cqrs-app

Create a project with a specific version:

mbc new my-cqrs-app@0.1.45

generate Command

Use Case: Add a New Domain to Existing Project

Scenario: Your project needs a new Order feature with API endpoints, business logic, and database entities.

Solution: Generate module, controller, service, entity, and DTO in sequence.

mbc generate <schematic> [name]
# or
mbc g <schematic> [name]

Available Schematics

Name	Alias	Description
module	mo	Create a module
controller	co	Create a controller
service	se	Create a service
entity	en	Create an entity
dto	dto	Create a DTO

Options

Option	Description
-d, --dry-run	Report actions that would be taken without writing out results
--mode <mode>	Specify the mode of operation: sync or async (default: async)
--schema	Enable schema generation (default: true)
--no-schema	Disable schema generation

Examples

Generate a new module:

mbc generate module order
# or
mbc g mo order

Generate a controller:

mbc generate controller order
# or
mbc g co order

Generate a service:

mbc generate service order
# or
mbc g se order

Generate an entity:

mbc generate entity order
# or
mbc g en order

Generate a DTO:

mbc generate dto order
# or
mbc g dto order

Dry run (preview without creating files):

mbc g mo order --dry-run

start Command

Use Case: Run Local Development Server

Scenario: You want to test API endpoints locally before deploying to AWS.

mbc start
# or
mbc s

ui-common Command

Use Case: Add Pre-built UI Components to Frontend

Scenario: You're building a frontend and want to use the standard MBC CQRS UI component library.

mbc ui-common [options]
# or
mbc ui [options]

This command integrates the MBC CQRS UI Common library into your project, providing pre-built UI components and utilities.

Options

Option	Description
-p, --pathDir <string>	(Required) The destination path for common-ui components
-b, --branch <string>	The branch name to clone from (default: main)
--auth <string>	The authentication method: SSH or HTTPS - Token (default: SSH)
--token <string>	The token for HTTPS authentication, format: tokenId:tokenPassword
-c, --component <string>	Component to install: all, appsync, or component (default: all)
--alias	Add alias configuration for common-ui in tsconfig.json

Examples

Install all components using SSH authentication:

mbc ui-common -p src/common-ui

Install only UI components (excluding appsync):

mbc ui -p src/common-ui -c component

Install from a specific branch:

mbc ui -p src/common-ui -b develop

Install using HTTPS with token authentication:

mbc ui -p src/common-ui --auth "HTTPS - Token" --token "user:password"

install-skills Command

Use Case: Install Claude Code Skills

Scenario: You want to use Claude Code skills for MBC CQRS Serverless development assistance.

mbc install-skills [options]
# or
mbc skills [options]

This command installs Claude Code skills that provide guided assistance for code generation, code review, migration, and debugging.

Options

Option	Description
-p, --project	Install to project directory (.claude/skills/) instead of personal (~/.claude/skills/)
-f, --force	Overwrite existing skills
-l, --list	List available skills without installing
-c, --check	Check if updates are available without installing

Examples

Install to personal skills directory (available in all projects):

mbc install-skills

Install to project directory (shared with team via git):

mbc install-skills --project
# or
mbc skills -p

List available skills:

mbc install-skills --list

Force overwrite existing skills:

mbc install-skills --force

Check for updates:

mbc install-skills --check

Upgrading Skills

Skills do not auto-update. To upgrade to the latest version:

# Update CLI to latest version
npm update -g @mbc-cqrs-serverless/cli

# Check if updates are available
mbc install-skills --check

# Force reinstall to get latest version
mbc install-skills --force

Available Skills

Skill	Description
/mbc-generate	Generate boilerplate code (modules, services, controllers, DTOs, handlers)
/mbc-review	Review code for best practices and anti-patterns (20 patterns)
/mbc-migrate	Guide version migrations and breaking changes
/mbc-debug	Debug and troubleshoot common issues

Version Note

The install-skills command was added in version 1.0.24.

Troubleshooting

Version not found

mbc new myapp@999.999.999
# Error: Version not found

Solution: Use a valid version number. Check available versions in npm registry.

Directory not empty

mbc new my-project
# Error: Directory not empty

Solution: Use a new directory or remove existing files before creating a project.

Permission denied

If you encounter permission errors during global installation:

sudo npm install -g @mbc-cqrs-serverless/cli
# or use npm prefix
npm config set prefix ~/.npm-global
npm install -g @mbc-cqrs-serverless/cli