> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexusproject.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

> Referencia completa del archivo nexus.yaml.

## Ubicación

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

## Schema Completo

```yaml theme={null}
# ─── 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

| Tool       | Comando            | Parámetros                     |
| ---------- | ------------------ | ------------------------------ |
| `gh`       | `gh auth switch`   | `account`                      |
| `aws`      | `aws sso login`    | `account`, `region`            |
| `supabase` | `supabase link`    | `account` (project-ref), `org` |
| `vercel`   | `vercel switch`    | `account`, `org`               |
| `mongosh`  | `atlas config set` | `account`                      |