Global flags
These flags apply to every command:| Flag | Default | Description |
|---|---|---|
--log-level | INFO | Log verbosity: DEBUG, INFO, WARNING, ERROR |
--format-output | json | Output format: json or human |
MAGE_AGENT_LOG_LEVEL as an environment variable:
mage-agent login
Authenticate with your Mage Pro cluster and save credentials.
| Option | Description |
|---|---|
--cluster-url URL | Mage Pro cluster URL |
--email EMAIL | Account email |
--password PASSWORD | Account password |
~/.mage-agent/config.json and fetches remote skill files from the cluster.
mage-agent mcp
Start the MCP stdio server. This is the command your IDE or AI agent launches.
mage-agent sync-project-to-local
Pull all remote project files to a local directory.
| Option | Default | Description |
|---|---|---|
--local-project-dir | .mage-agent/local_sync | Destination directory |
mage-agent sync-status
Show what has changed between local and remote.
remote_to_local, local_to_remote, conflicts, in_sync.
Use --format-output human for a readable table.
mage-agent sync-local-to-remote
Push locally changed files to the cluster.
local_to_remote status are uploaded.
mage-agent sync
Bidirectional sync with interactive conflict resolution.
[r]emote / [l]ocal / [s]kip.