CLI Tool

Install CodeMod Forge

The same migration engine that powers the web experience, available in your terminal.

Recommended

npm install

npm install -g codemod-forge

Global install, always available

Zero Install

npx

npx codemod-forge analyze

Run instantly, no install needed

Source

GitHub

Clone Repository →

Build from source

System Requirements

Node.js

v18.0.0 or higher

OpenAI API Key

Required for analysis features

Operating System

macOS, Linux, Windows

Quick Start

# Set your API key $ export OPENAI_API_KEY=sk-... # Analyze your repository $ forge analyze --dir ./my-project # View migration plan $ forge plan react --from 17 --to 19 --dir ./my-project # Run migration (dry-run first) $ forge migrate react --from 17 --to 19 --dir ./my-project --all --dry-run # Apply approved changes $ forge migrate react --from 17 --to 19 --dir ./my-project --all --yes # Verify results $ forge verify --dir ./my-project # View report $ forge report --dir ./my-project # Rollback if needed $ forge rollback --dir ./my-project

CLI Commands

Command	Description	Key Flags
forge analyze	Scan repo, detect frameworks, score health	--dir, --verbose
forge plan <lib>	Extract breaking changes, show migration plan	--from, --to, --guide
forge migrate <lib>	Full pipeline: plan, generate, validate, apply	--dry-run, --all, --yes
forge verify	Re-run transforms in dry-run mode	--dir
forge rollback	Restore from most recent backup	--dir
forge report	Display migration report from last run	--dir

Browser vs CLI

Browser Experience

✓ Visual workflow with 10 interactive steps
✓ Side-by-side diff previews
✓ Interactive risk analysis dashboard
✓ Shareable impact reports
✓ Best for exploring and reviewing

CLI Experience

✓ Full pipeline in one command
✓ CI/CD integration
✓ Scriptable and automatable
✓ Custom migration guide URLs
✓ Best for executing and automating

The browser plans, the CLI executes. Same engine, same trust.