> ## 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.

# Famulor CLI

> Todo tu espacio de trabajo de Famulor en el terminal: cada operación de la API como un comando

La Famulor CLI lleva toda la API REST a tu terminal. Crea asistentes, inicia llamadas, ejecuta campañas, gestiona leads y números de teléfono y consulta el historial de llamadas con una sola herramienta. Todo lo que puedes hacer a través de la API también puedes convertirlo en un script, ejecutarlo en CI o dejárselo a un agente de código.

```bash theme={null}
npm install --global famulor
famulor auth login
famulor list-assistants --output table
```

<Note>
  La CLI es una versión preliminar pública (versión 0.x). Los nombres de los comandos siguen la API y todavía pueden cambiar antes de la 1.0. Un comando renombrado sigue funcionando durante al menos una versión menor.
</Note>

## Requisitos

* **Node.js 22** o posterior.
* Un plan del espacio de trabajo con **API Access**, el mismo requisito que la [API REST](/es/api-reference/introduction#acceso-a-la-api).
* Una clave de API de **Settings → API & MCP**.

## Inicio rápido

<Steps>
  <Step title="Instala">
    ```bash theme={null}
    npm install --global famulor
    ```
  </Step>

  <Step title="Inicia sesión">
    Crea una clave de API en **Settings → API & MCP** y ejecuta:

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

    Pega la clave cuando se te pida. Lo que escribes permanece oculto y la clave se guarda en el llavero de tu sistema.
  </Step>

  <Step title="Ejecuta tus primeros comandos">
    ```bash theme={null}
    famulor list-assistants --output table
    famulor list-calls --status completed --limit 10 --output table
    famulor create-call --assistant-id <assistant-id> --to-number +4930123456
    ```
  </Step>
</Steps>

## Cómo funcionan los comandos

Cada operación de la [referencia de la API](/es/api-reference/introduction) es un comando. El nombre del comando es el ID de la operación en kebab case, así que **Start an outbound call** (`createCall`) se convierte en `famulor create-call`.

* **Los parámetros de ruta** son argumentos: `famulor get-assistant <id>`.
* **Los parámetros de consulta y los campos del cuerpo** son opciones en kebab case: `assistant_id` se convierte en `--assistant-id`.
* Las opciones **tienen tipo y se validan** antes de enviar nada: los números deben ser números, las opciones de una lista deben ser uno de los valores permitidos y los campos obligatorios deben estar presentes.

```bash theme={null}
famulor --help               # areas and the most useful commands
famulor assistants           # every command in one area
famulor assistants create --name "Front desk"  # area and verb work too
famulor commands recording   # search all commands
famulor create-call --help   # arguments, options, required fields and an example
```

## Más información

<CardGroup cols={2}>
  <Card title="Inicio de sesión y espacios de trabajo" href="/es/cli/authentication" icon="key">
    Almacenamiento en el llavero, claves para CI, un perfil por espacio de trabajo y dominios de marca blanca.
  </Card>

  <Card title="Comandos y salida" href="/es/cli/commands" icon="terminal">
    Cuerpos de solicitud, subida de archivos, tablas, JSON Lines, paginación y descargas.
  </Card>

  <Card title="Scripts, CI y agentes de código" href="/es/cli/scripting" icon="robot">
    Automatización segura, códigos de salida, pipelines con `jq` y el esquema de comandos para agentes.
  </Card>

  <Card title="Referencia" href="/es/cli/reference" icon="book">
    Opciones globales, variables de entorno, códigos de salida y solución de problemas.
  </Card>
</CardGroup>

<Tip>
  ¿Trabajas dentro de un asistente de IA como Claude o ChatGPT en lugar de en un terminal? Conéctalo a través del [servidor MCP](/es/mcp/overview). Ofrece las mismas funciones en forma de herramientas.
</Tip>