Skip to main content

​
Paso 1: Descargar e instalar el CLI

Ya no es necesario clonar el repositorio ni tener Go instalado. Simplemente descarga el archivo precompilado.
  1. Ve a la página de Releases en GitHub y descarga el archivo para tu sistema operativo.
  2. Extrae el archivo (si viene comprimido) y renómbralo a nexus (o nexus.exe en Windows).
  3. Configúralo en tu sistema:
# Instalar globalmente
$installDir = "$env:USERPROFILE\.nexus\bin"
New-Item -ItemType Directory -Force -Path $installDir | Out-Null
# Mueve el nexus.exe descargado a esa carpeta
Move-Item nexus.exe "$installDir\nexus.exe" -Force

# Agregar al PATH (permanente, solo la primera vez)
$currentPath = [System.Environment]::GetEnvironmentVariable("Path", "User")
if ($currentPath -notlike "*\.nexus\bin*") {
    [System.Environment]::SetEnvironmentVariable("Path", "$currentPath;$installDir", "User")
}
Reinicia tu terminal después de agregar al PATH para que tome efecto.
Verifica la instalación: 
nexus version
# → Nexus v0.1.0
Si ves Nexus v0.1.0, la instalación fue exitosa.

​
Paso 2: Crear cuenta y API Key

1

Registrarte en el Dashboard

Ve a nexus-production-a677.up.railway.app y crea tu cuenta.
2

Crear un proyecto

En el dashboard, crea un proyecto y agrega entornos (development, staging, production). Configura los CLI profiles (GitHub, AWS, etc.) y variables de entorno (API keys, secrets).
3

Generar una API Key

Ve a Configuración → API Keys → Generar Nueva Key.
La key completa (ag_live_...) solo se muestra una vez. Cópiala antes de cerrar el modal.

​
Paso 3: Conectar el CLI

# Autenticarte con tu API key
nexus login

🔐 Nexus CLI — Login
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Generate an API key from your Dashboard:
  → Settings → API Keys → Generate New Key

Paste your API key: ag_live_xxxxxxxxxx...

✅ Authenticated as Ricardo (hackminor@live.com.mx)
📋 Plan: free

Run 'nexus sync' to pull your projects from the cloud.

​
Paso 4: Sincronizar proyectos

nexus sync

🔄 Nexus Sync
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Authenticating... ✅ hackminor@live.com.mx
  Pulling projects... ✅ 2 projects found

📦 Cloud Projects:
  ✅ Auto Hotel Luxor (auto-hotel-luxor)
      └─ production (branch: main, 3 tools)
      └─ development (branch: develop, 2 tools)
  ✅ Natura Inventory (natura-inventory)
      └─ production (branch: main, 2 tools)

✅ Sync complete!

​
Paso 5: ¡Hacer switch!

# Desde CUALQUIER directorio
nexus switch auto-hotel-luxor --env production

   ___         __  _                       _ __       
  / _ | ___   / /_(_)__ _______ __  _____ (_) /___ __ 
 / __ |/ _ \ / __/ / _ '/ __/ _ '/ |/ / -_) / __/ // /
/_/ |_/_//_/ \__/_/\_, /_/  \_,_/|___/\__/_/\__/\_, / 
                  /___/                         /___/  

  ☁️  Cloud mode — fetching project 'auto-hotel-luxor'
  🚀 Switching context → Auto Hotel Luxor / production

  ─────────────────────────────────────────
  ✅ gh → epigibson
  ✅ aws → luxor-prod
  ✅ supabase → linked
  ✅ env vars → 4 variables set
  📌 git branch — main
  ─────────────────────────────────────────

  ✅ Context switch complete!
Ahora tu GitHub CLI, AWS, Supabase y todas las variables de entorno están configuradas para el proyecto correcto. Listo para desarrollar.

​
Comandos disponibles

ComandoDescripción
nexus loginAutenticarte con tu API key
nexus syncSincronizar proyectos del cloud
nexus statusVer estado de conexión
nexus switch <proyecto> --env <env>Cambiar contexto completo
nexus listListar proyectos locales
nexus initCrear nexus.yaml local
nexus logoutDesconectar del cloud
nexus versionVer versión

​
Troubleshooting

Asegúrate de que ~/.nexus/bin está en tu PATH y que reiniciaste la terminal después de instalarlo.Windows: Verifica con $env:Path -split ";" | Where-Object { $_ -like "*nexus*" }macOS/Linux: Verifica con echo $PATH | tr ':' '\n' | grep nexus
  • Verifica que copiaste la API key completa (empieza con ag_live_)
  • Genera una nueva key desde el dashboard si la anterior expiró
  • Verifica conexión a internet
Si ves un error interno al crear la key, espera 2 minutos para que Railway redeployee tras un push reciente.