ultra migrate - Ultra

Discover MCP connectors configured in your agents and import them into Ultra’s configuration.

Usage

ultra migrate [flags]

Flags

Flag	Short	Default	Description
`--config`			Path to Ultra config file
`--yes`	`-y`	`false`	Skip confirmation prompt
`--list`	`-l`	`false`	List discovered connectors without migrating
`--dry-run`		`false`	Preview changes without applying
`--from`			Migrate from specific agent only (`claude`, `cursor`, `codex`, `ona`, `hermes`, etc.)
`--connector`			Migrate only the named connector(s); repeatable (formerly `--server`, which remains a deprecated alias)

Examples

# Interactive migration wizard
ultra migrate

# List discovered MCP connectors without migrating
ultra migrate --list

# Dry run to preview changes
ultra migrate --dry-run

# Migrate from a specific agent only
ultra migrate --from claude

# Non-interactive migration
ultra migrate --yes

# Migrate into a named profile's config
ultra --profile dev migrate

How It Works

Scans Claude Desktop, Cursor, Codex, Ona, Hermes, and other agent config files for MCP connector entries
Deduplicates connectors found in multiple agents
Validates connector configurations and warns about issues
Writes discovered connectors to Ultra’s config as upstream entries
Updates agent configs to point to Ultra

Dry Run

The --dry-run flag shows exactly what Ultra config would be generated without making any changes. Useful for reviewing the migration before committing.

Profiles

ultra migrate respects the global --profile flag. When a profile is set, the migration writes to that profile’s config path instead of the default.

# Default: writes to ~/.config/ultra/config.yaml
ultra migrate

# With profile: writes to ~/.config/ultra/profiles/dev/config.yaml
ultra --profile dev migrate

You can also set the ULTRA_PROFILE environment variable instead of passing --profile on every invocation.