open-index/open-npm huggingface dataset:
npm package: @migration-accelerator/migration-accelerator-cli
Description: CLI for Migration Accelerator: manage orgs, sites, templates, components, mappings, AI mapping, and migrations.
Latest version: 0.1.0

# 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`.