Connection Commands

Manage connection profiles for Magento instances. Profiles store system type, instance URL, and authentication settings. The active profile is used for all API commands.

connection add

Create a new profile via interactive prompts.

mage-remote-run connection add

Prompts include:

System type (Open Source, Mage-OS, Adobe Commerce on-prem, PaaS, SaaS)
Instance URL
Authentication method and credentials

connection list

List all profiles and show which one is active.

mage-remote-run connection list

connection search `<query>`

Filter profiles by name.

mage-remote-run connection search staging

connection delete `<name>`

Delete a profile after confirmation.

mage-remote-run connection delete my-store

connection edit `<name>`

Edit an existing profile using the same prompts as add.

mage-remote-run connection edit my-store

connection select

Pick the active profile from a list.

mage-remote-run connection select

connection status

Show the active profile and basic details.

mage-remote-run connection status

connection test

Test connectivity for the active profile or all profiles.

mage-remote-run connection test
mage-remote-run connection test --all

connection clear-token-cache

Remove the cached access token so the next command fetches a fresh one.

mage-remote-run connection clear-token-cache

connection add​

connection list​

connection search <query>​

connection delete <name>​

connection edit <name>​

connection select​

connection status​

connection test​

connection clear-token-cache​