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

# Inicio de sesión y espacios de trabajo

> Claves de API, el llavero del sistema, credenciales para CI, un perfil por espacio de trabajo y dominios de marca blanca

La CLI firma las solicitudes con una clave de API del espacio de trabajo, la misma credencial que usa la API REST. Créala en el panel, en **Settings → API & MCP**. La clave completa se muestra una sola vez.

## Iniciar sesión

```bash theme={null}
famulor auth login
```

La CLI te ofrece abrir la página de ajustes en tu navegador y después te pide la clave. Lo que escribes permanece oculto. Antes de guardar nada, la clave se comprueba con la API, así que nunca se guarda una clave mal escrita o revocada.

Tras iniciar sesión correctamente, ves el espacio de trabajo, el nombre de la clave y sus alcances. La clave se guarda en el llavero de tu sistema:

| Sistema | Dónde se guarda la clave |
| - | - |
| macOS | Llavero de macOS |
| Windows | Administrador de credenciales |
| Linux | Secret Service (por ejemplo, GNOME Keyring o KWallet) |

Si no hay ningún llavero disponible, la CLI usa un archivo en `~/.config/famulor` al que solo tú tienes acceso, y te lo indica.

```bash theme={null}
famulor auth whoami     # workspace, key name and scopes behind the login
famulor auth status     # all saved logins, and whether the active one still works
famulor auth logout     # remove the saved key from this computer
```

<Note>
  Cerrar sesión solo elimina la clave de tu equipo. Para invalidar la propia clave, revócala en **Settings → API & MCP**.
</Note>

## CI y scripts

En los pipelines, define `FAMULOR_API_KEY` desde tu almacén de secretos. Tiene prioridad sobre cualquier inicio de sesión guardado y no se escribe nada en el disco:

```bash theme={null}
export FAMULOR_API_KEY="fam_..."
famulor list-calls --status completed --limit 50
```

Para guardar una clave sin un aviso interactivo y sin que quede en el historial de tu shell, pásala por una tubería:

```bash theme={null}
printf '%s' "$FAMULOR_API_KEY" | famulor auth login --with-token
```

## Varios espacios de trabajo

Una clave de API pertenece exactamente a un espacio de trabajo. Guarda un perfil para cada espacio de trabajo y cambia entre ellos:

```bash theme={null}
famulor auth login --profile agency     # log in a second workspace
famulor auth switch agency              # make it the default
famulor list-assistants --profile default   # use another profile once
```

`FAMULOR_PROFILE` selecciona un perfil para toda una sesión del shell.

## Dominios de marca blanca

Si usas Famulor con tu propio dominio, inicia sesión una vez con ese dominio. El perfil lo recuerda y todos los comandos lo usan a partir de entonces:

```bash theme={null}
famulor auth login --base-url app.example.com
```

Las rutas de la API, las claves y los alcances son los mismos en todos los dominios.

## Comprobar tu configuración

`famulor doctor` comprueba de una sola vez tu versión de Node.js, el inicio de sesión guardado, el host, la conexión de red y API Access, y te indica qué debes corregir:

```bash theme={null}
famulor doctor
```