Migration Accelerator CLI (ma)

A command-line interface to manage Migration Accelerator resources and workflows.

• Auth + organization context
• Site, template, component, and content mapping management
• AI-assisted content mapping (single page and batch, with streaming)
• Migration lifecycle controls (start, logs, download, send)
• Monitoring and error reporting

For detailed command docs, see docs/cli/README.md.

Install

• Requires Node.js 18+
• After publish: npm install -g @migration-accelerator/migration-accelerator-cli

Temporary local usage (from repo):

• npm run ma -- --help
• node index.js --help
• npx @migration-accelerator/migration-accelerator-cli --help

Quick Start

1. Configure API base (optional):

• export MIGRATION_ACCELERATOR_API_URL="https://your-api.example.com"

2. Login:

• ma login (prompts for credentials and MFA if required)

3. Set organization:

• ma org list
• ma org use <orgId>

4. Explore commands:

• ma --help
• ma site list

Global Options

• --json Print raw JSON responses
• --quiet Reduce output, hide spinners
• --debug Verbose debug logging (includes request metadata)
• --org <id> Override active organization for a single command

Environment Variables

• MIGRATION_ACCELERATOR_API_URL Override API base URL (default http://localhost:8000)
• MA_TOKEN Provide an auth token (bypasses interactive login)

Configuration

The CLI stores user config at ~/.ma-cli/config.json, including:

• apiBaseUrl Last used API base
• token Auth token
• activeOrganizationId Selected organization
• deviceToken Trusted device token for MFA

You can always override organization per-command with --org <id>.

Commands Overview

• auth Login, whoami, logout
• org Organization selection and info
• site Manage sites within an organization
• template Manage template rules per site
• component Manage component structures per site
• mapping Manage content mappings per site
• ai AI-assisted mapping (single or batch, with optional SSE streaming)
• migrate Manage migration lifecycle and artifacts
• monitor Inspect error aggregates and export reports

See details and examples in docs/cli/README.md.

Contributing

• Open an issue or PR with improvements.
• Before publishing, validate with npm pack and try npx . -- --help.