Skip to main content
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

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: 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.
Cerrar sesión solo elimina la clave de tu equipo. Para invalidar la propia clave, revócala en Settings → API & MCP.

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:
Para guardar una clave sin un aviso interactivo y sin que quede en el historial de tu shell, pásala por una tubería:

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:
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:
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: