CLI Overview

The ModernizeSpec CLI wraps the SDK for terminal use. It provides six commands covering the full modernization lifecycle.

Installation

# Use directly with npx (no install)
npx modernizespec <command>

# Install globally
npm install -g @modernizespec/cli

# Install as dev dependency
npm install -D @modernizespec/cli

Commands

Command	Description	Phase
init	Interactive wizard to create .agents/modernization/	Setup
analyze	Scan codebase and suggest DDD mapping	Analysis
validate	Check compliance against JSON Schemas	Verification
progress	Show current extraction status	Tracking
diff	Compare legacy vs modern behavior	Verification
export	Export dashboard as HTML or JSON	Reporting

Lifecycle Flow

1. init — Create the spec files (once)
2. analyze — Scan the codebase for bounded contexts and complexity (periodic)
3. validate — Verify spec files are correct (every commit)
4. progress — Check extraction status (during work)
5. diff — Compare legacy and modern behavior (after extraction)
6. export — Generate reports for stakeholders (as needed)

Global Flags

Flag	Description
--dir <path>	Target directory (default: current directory)
--verbose	Show detailed output
--json	Output results as JSON (for piping)
--help	Show help for any command
--version	Show CLI version

Exit Codes

Code	Meaning
0	Command completed successfully
1	Validation errors or command failure
2	Spec files not found

Next Steps

• init — Start with the interactive wizard
• @modernizespec/sdk — Programmatic API behind the CLI