Skip to main content

Ubicación

El archivo nexus.yaml se ubica en la raíz del proyecto o en ~/.nexus/config.yaml como global.

Schema Completo

# ─── Metadatos del proyecto ───
project:
  name: my-project              # Nombre descriptivo del proyecto
  slug: my-project              # Identificador único (slug) usado en comandos
  repo: "https://github.com/..." # URL del repositorio de Git (clave 'repo', NO 'repo_url')

# ─── Entornos ───
environments:
  development:                  # Nombre del entorno (mapeo indexado por clave, NO una lista)
    branch: develop            # Rama de Git
    env:                       # Variables de entorno (clave 'env', NO 'env_vars')
      NODE_ENV: development
      DATABASE_URL: postgresql://localhost/dev
    cli_profiles:              # Perfiles de herramientas CLI
      - tool: gh               # Herramienta (gh, aws, supabase, vercel, mongosh, etc.)
        account: dev-personal  # Identificador de cuenta/perfil
        org: acme              # Organización (opcional)
        region: us-east-1      # Región (opcional, AWS/cloud)

  staging:
    branch: staging
    env:
      NODE_ENV: staging
    cli_profiles:
      - tool: gh
        account: acme-bot
      - tool: aws
        account: acme-staging
        region: us-east-1

  production:
    branch: main
    env:
      NODE_ENV: production
    cli_profiles:
      - tool: gh
        account: acme-bot
      - tool: aws
        account: acme-prod
        region: us-east-1

# ─── Skills ───
skills:
  - name: context-injection    # Inyección de env vars
    category: context-injection
    enabled: true
    priority: 1                # Orden de ejecución
  - name: git-state            # Cambio de rama
    category: git-state
    enabled: true
    priority: 2
  - name: cli-switching        # Cambio de CLI profiles
    category: cli-switching
    enabled: true
    priority: 3

Tools Soportados

ToolComandoParámetros
ghgh auth switchaccount
awsaws sso loginaccount, region
supabasesupabase linkaccount (project-ref), org
vercelvercel switchaccount, org
mongoshatlas config setaccount