momentumreim

CLI oficial de Momentum REIM para consultar datos de Brain, Hub, Pulse, Tickets y Works desde la terminal.

Instalación

npm install -g momentumreim

Uso básico

# Login con tu cuenta Momentum
momentumreim login

# Quién soy
momentumreim whoami

# Logout
momentumreim logout

Seguridad

Este CLI es público en npm, pero tus datos están protegidos:

• Solo contiene URLs públicas de Supabase y claves anón (diseñadas para ir en frontend).
• Necesitas login con tu cuenta de Momentum → obtienes un JWT propio.
• Row Level Security (RLS) de Supabase filtra automáticamente lo que puedes ver.
• Tu sesión se guarda en ~/.momentumreim/session.json (permisos 0600, solo tu usuario).
• El JWT se refresca automáticamente mientras tu sesión esté activa.

Flags globales

| Flag | Descripción | |---|---| | --json | Output en JSON (ideal para scripts y para que Builder/Mom-IA consuman datos) | | --help | Ayuda de cualquier comando | | -v, --version | Versión del CLI |

🏛️ Brain — Portal corporativo

| Comando | Descripción | |---|---| | brain profile [email] | Ver perfil (propio si no se indica email) | | brain users | Listar usuarios del portal | | brain departments | Listar departamentos | | brain auth-logs | Ver logs de autenticación |

🏢 Hub — CRM comercial

| Comando | Descripción | |---|---| | hub leads | Listar leads | | hub leads-show <id> | Detalle de un lead | | hub leads-search <query> | Buscar leads | | hub projects | Listar proyectos | | hub projects-show <name> | Detalle de un proyecto | | hub units | Listar unidades/viviendas | | hub pipeline | Resumen del funnel | | hub marketing | Inversiones de marketing | | hub reviews | Reseñas de proyectos |

💼 Pulse — Deals de inversión

| Comando | Descripción | |---|---| | pulse deals | Listar deals | | pulse deals-show <id> | Detalle de un deal | | pulse deals-search <query> | Buscar deals | | pulse pipeline | Resumen del pipeline | | pulse dd <asset_id> | Progreso de Due Diligence | | pulse dd-items <asset_id> | Items del checklist DD | | pulse actions [asset_id] | Últimas acciones/notas | | pulse comparables <asset_id> | Comparables de mercado |

🎫 Tickets — Gastos y kilometraje

| Comando | Descripción | |---|---| | tickets expenses | Listar tus gastos | | tickets expenses-summary | Resumen del mes actual | | tickets mileage | Listar kilometraje | | tickets approvals | Peticiones pendientes de aprobar (si eres aprobador) | | tickets conventions | Ver tarifas de convenios |

🏗️ Works — Predicción de costes

| Comando | Descripción | |---|---| | works projects | Listar obras | | works project-show <id> | Detalle de una obra | | works curves <project_id> | Curva mensual de progreso | | works index | Histórico del índice de costes | | works index-latest | Valor más reciente del índice |

Ejemplos

# Ver mis gastos del mes
momentumreim tickets expenses-summary

# Pipeline de inversión
momentumreim pulse pipeline

# Leads nuevos esta semana
momentumreim hub leads --week

# Buscar un deal
momentumreim pulse deals-search "Mateo Inurria"

# DD de un deal específico
momentumreim pulse dd abc-123-def

# Output JSON para procesar en shell
momentumreim --json hub leads --status bloqueo | jq '.[] | .name'

Roadmap

v0.1.0 (actual) — read-only

Consultas de solo lectura para los 5 apps. ~33 comandos.

v0.2.0 (próximamente)

• Creaciones (new lead, new expense, new deal…)
• Actualizaciones (update status, tag, assign…)
• Aprobaciones (tickets approve/reject)
• ~150 comandos adicionales

v0.3.0

• Exports a Excel/CSV
• Operaciones bulk
• Comandos de administración
• Reports consolidados
• ~130 comandos adicionales

Total final: ~360 comandos cubriendo todo el ecosistema Momentum.

Desarrollo

git clone [email protected]:momentumreimspain/momentumreim-cli.git
cd momentumreim-cli
npm install
node bin/momentumreim.js --help

Licencia

MIT © Momentum REIM