Skip to main content

​
Global flags

These flags apply to every command: You can also set MAGE_AGENT_LOG_LEVEL as an environment variable:

​
mage-agent login

Authenticate with your Mage Pro cluster and save credentials.
If any option is omitted, the CLI prompts interactively. On success, writes ~/.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.
No options. The server reads JSON-RPC requests from stdin and writes responses to stdout. Logs go to stderr.

​
mage-agent sync-project-to-local

Pull all remote project files to a local directory.

​
mage-agent sync-status

Show what has changed between local and remote.
Output groups files into: 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.
Only files with local_to_remote status are uploaded.

​
mage-agent sync

Bidirectional sync with interactive conflict resolution.
For each conflicting file, prompts: [r]emote / [l]ocal / [s]kip.