mg CLI

mg es la interfaz de línea de comandos de Moftgate Center. Es un único binario estático para macOS, Linux y Windows que se comunica con su Center mediante su API. Todo lo que hace en la consola — listar dispositivos, triar alertas, ejecutar scripts, seguir ejecuciones — está disponible como comando.

mg está diseñado para dos audiencias a la vez: operadores que prefieren el terminal y agentes de IA que usan los mismos comandos mediante un archivo SKILL.md generado.

mg auth login
mg device list --group Servers --limit 3
mg alert list --severity critical

Los perfiles permiten que un binario mg hable con varios Center: su Center de producción, un entorno de staging o un tenant de cliente. Cada perfil almacena una URL y sus propias credenciales.

mg --version
mg profile create prod https://center.example.local
mg profile use prod
mg profile list
mg profile delete staging

1. 1
   Apunte un perfil a su Center

   Ejecute mg profile create <name> <url> para registrar la URL del Center y luego selecciónelo con mg profile use <name>. Los perfiles múltiples permiten cambiar entre producción, staging o tenants de clientes.

2. 2
   Inicie sesión desde el navegador

   mg auth login abre un flujo de aprobación en el navegador. Tras aprobar, se emite un token al CLI que se guarda localmente bajo el perfil activo.

3. 3
   Verifique la sesión

   mg auth status muestra la sesión activa y la organización a la que pertenece el token.

4. 4
   Cierre sesión al terminar

   mg auth logout revoca el token en el Center y elimina las credenciales locales del perfil.

mg auth login
mg auth status
mg auth logout

Cada ejecución de script — ad hoc o guardada — produce una ejecución (run). Las ejecuciones son el registro de auditoría de qué se ejecutó, dónde y con qué resultado.

mg run list --status failed
mg run inspect r-9042
mg run retry r-9042 --yes

Los comandos de lista imprimen por defecto una tabla legible con color. Pase -o json para salida legible por máquina, o --jq para proyectar campos directamente — la salida jq implica JSON. mg device export produce CSV.

mg device list -o json
mg device list --jq '.list[] | {id, hostname, status}'
mg device list --limit all --jq '.list | length'

mg incluye un generador de skills integrado. SKILL.md enseña a los agentes de código — Claude Code, Codex, Gemini y otros que leen la convención .agents/skills — cómo autenticarse, qué comandos existen y qué flags usar.

mg skill install            # user level: ~/.agents/skills/moftgate/SKILL.md
mg skill install --project  # repo level: ./.agents/skills/moftgate/SKILL.md
mg skill describe script run

• Los tokens se emiten por perfil mediante el flujo de aprobación del navegador y se revocan con mg auth logout.
• Las operaciones de escritura (resolver alertas, ejecutar scripts, cancelar/reintentar ejecuciones) requieren permiso de escritura en el usuario emisor.
• Las operaciones de riesgo piden confirmación interactiva; --yes omite el prompt para CI y automatización.
• Para Center on-premises con certificados autofirmados, pase --ca-bundle <path> en lugar de desactivar la verificación.
• --insecure desactiva la verificación TLS por completo. Existe para desarrollo — nunca lo apunte a un Center de producción.