# CLI de Circleback (/docs/es/support/platform/circleback-cli)

Accede a todo desde la línea de comandos o dales a tus agentes de IA el contexto de conversación que necesitan para hacer las cosas. Pídele a OpenClaw que dé seguimiento a las tareas pendientes de la reunión diaria de esta mañana. Deja que Claude Code redacte una especificación basada en tu última revisión de producto.

## Configuración

Para empezar, instala la [CLI de Circleback](https://www.npmjs.com/package/@circleback/cli):

```
npm install -g @circleback/cli
```

Luego, inicia sesión en tu cuenta de Circleback:

```
cb auth login
```

Esto abre una ventana del navegador para iniciar sesión. Una vez que inicies sesión, ya puedes empezar.

Para iniciar sesión con una clave de API:

```
cb auth login --api-key
```

El inicio de sesión con clave de API enlaza a [**Configuración → Claves de API**](https://circleback.ai/settings?tab=api-access), verifica la clave y la guarda localmente en tu dispositivo.

Para una automatización sin estado, define `CIRCLEBACK_API_KEY` en lugar de iniciar sesión:

```
CIRCLEBACK_API_KEY=cb_your_api_key cb meetings --json
```

`CIRCLEBACK_API_KEY` tiene prioridad sobre las credenciales guardadas.

Para cerrar sesión en este dispositivo:

```
cb auth logout
```

## Qué puedes hacer

La CLI de Circleback tiene comandos para buscar, consultar y actualizar datos de tu cuenta de Circleback, como reuniones, transcripciones, eventos de calendario, correos electrónicos, personas, empresas y más.

| Comando | Descripción |
| -------------------------------- | --------------------------------------------------------------------------------------------- |
| `cb auth login` | Inicia sesión en Circleback con tu navegador |
| `cb auth login --api-key` | Inicia sesión con una clave de API |
| `cb auth logout` | Cierra sesión en este dispositivo |
| `cb update` | Actualiza la CLI a la versión más reciente |
| `cb meetings [search]` | Busca reuniones y transcripciones |
| `cb meetings read <ids...>` | Lee los detalles, las notas y las tareas pendientes de reuniones (hasta 50 reuniones) |
| `cb meetings update <id>` | Actualiza una reunión |
| `cb meetings share <id>` | Comparte una reunión con una persona, un equipo, un espacio de trabajo o cualquier persona con el enlace, o quita el acceso |
| `cb transcripts read <ids...>` | Obtén la transcripción completa de una o más reuniones, con etiquetas de hablantes y marcas de tiempo |
| `cb action-items [search]` | Busca tareas pendientes por palabra clave, estado (pendiente o completada), responsable, etiqueta, empresa o rango de fechas |
| `cb action-items create <title>` | Crea una tarea pendiente, asignada a ti a menos que definas `--assignee` |
| `cb action-items update <id>` | Actualiza una tarea pendiente |
| `cb action-items delete <id>` | Elimina una tarea pendiente |
| `cb calendar` | Busca eventos de calendario próximos y pasados, incluidos los ID de eventos, los asistentes y los enlaces de reunión |
| `cb calendar update <id>` | Actualiza un evento de calendario |
| `cb emails [search]` | Busca hilos en las cuentas de correo electrónico conectadas por palabra clave, remitente, destinatario o rango de fechas |
| `cb people <names...>` | Busca personas por nombre para ver su perfil y su historial de interacciones en las reuniones |
| `cb companies <terms...>` | Busca empresas por nombre o dominio para encontrar su dominio y las reuniones relacionadas |
| `cb teams` | Muestra tu espacio de trabajo y tus equipos, con los ID para compartir |
| `cb tags` | Muestra todas las etiquetas de tu espacio de trabajo, útil para filtrar reuniones, transcripciones o tareas pendientes |
| `cb tags create <name>` | Crea una etiqueta, opcionalmente con una descripción y un color |
| `cb tags update <id>` | Actualiza el nombre, la descripción o el color de una etiqueta |
| `cb tags delete <id>` | Elimina una etiqueta y la quita de todas las reuniones |
| `cb folders` | Muestra las carpetas que puedes ver, con sus ID |
| `cb folders read <ids...>` | Obtén los miembros, los equipos y las reglas de una carpeta |
| `cb folders create <name>` | Crea una carpeta en un espacio de trabajo |
| `cb folders update <id>` | Actualiza el nombre, la descripción, el ícono, el color, la visibilidad o las reglas de una carpeta |
| `cb folders delete <id>` | Elimina una carpeta |
| `cb folders share <id>` | Comparte una carpeta con una persona, un equipo, un espacio de trabajo o cualquier persona con el enlace, o quita el acceso |
| `cb support [search]` | Busca en la documentación de soporte de Circleback ayuda y guías prácticas |

## Ejemplos

Sin un término de búsqueda, `cb meetings` abarca los últimos 7 días (a menos que uses `--folder`) y `cb action-items`, los últimos 30. Agrega `--last`, `--from` o `--to` para buscar en otro rango.

### Reuniones

Busca reuniones y fragmentos de transcripciones sobre un tema específico:

```
cb meetings search "product review"
```

Busca reuniones de los últimos 7 días:

```
cb meetings search --last 7
```

Busca reuniones en un rango de fechas:

```
cb meetings search --from 2026-04-01 --to 2026-04-18
```

Busca reuniones compartidas contigo en las que participe alguien de Acme:

```
cb meetings search --ownership Shared --domains acme.com
```

Lee todos los detalles de una reunión:

```
cb meetings read abc123
```

Lee varias reuniones a la vez:

```
cb meetings read abc123 def456
```

Comparte una reunión con personas por correo electrónico (separados por comas) o activa el acceso de lectura para el enlace:

```
cb meetings share abc123 --email dana@acme.com,lee@acme.com --access Viewer --send-email
cb meetings share abc123 --link Viewer
```

Quita el acceso a alguien o desactiva el enlace propio de la reunión:

```
cb meetings share abc123 --profile 42 --access none
cb meetings share abc123 --link none
```

Comparte una reunión con un equipo usando su ID de `cb teams`:

```
cb meetings share abc123 --team 7 --access Viewer
```

Cambia el nombre de una reunión:

```
cb meetings update abc123 --name "Pricing sync"
```

### Transcripciones

Obtén la transcripción completa de una reunión:

```
cb transcripts read abc123
```

Obtén las transcripciones de varias reuniones:

```
cb transcripts read abc123 def456
```

### Tareas pendientes

Busca tus tareas pendientes sin completar:

```
cb action-items search --status PENDING
```

Busca tareas pendientes por palabra clave:

```
cb action-items search "follow up"
```

Busca tareas pendientes completadas:

```
cb action-items search --status DONE
```

Busca tareas pendientes de reuniones con Acme, sin importar a quién estén asignadas:

```
cb action-items search --assignee-type Anyone --domains acme.com
```

Busca tareas pendientes asignadas a uno de tus equipos (usa `cb teams` para encontrar su ID):

```
cb action-items search --team 7
```

Crea una tarea pendiente y asígnala a alguien (usa `cb people` para encontrar su ID). Sin `--assignee`, se te asigna a ti; usa `--assignee none` para dejarla sin asignar:

```
cb action-items create "Send the renewal quote" --description "Include 2027 pricing" --assignee 42
```

Vincula una tarea pendiente a una reunión que puedes editar (usa `cb meetings` para encontrar su ID):

```
cb action-items create "Send the renewal quote" --meeting abc123
```

Marca una tarea pendiente como completada o quita su responsable:

```
cb action-items update 1234 --status DONE
cb action-items update 1234 --assignee none
```

Elimina una tarea pendiente:

```
cb action-items delete 1234
```

### Calendario

Consulta los eventos de calendario en un rango de fechas:

```
cb calendar search --from 2026-04-18 --to 2026-04-25
```

Agrega notas de preparación a un evento próximo usando su ID de `cb calendar`. Aparecen en tus notas privadas cuando se graba la reunión:

```
cb calendar update event123 --private-notes "Ask about the 2027 pricing"
```

### Correos electrónicos

Busca correos electrónicos por palabra clave:

```
cb emails search "quarterly report"
```

Busca correos electrónicos por participante:

```
cb emails search "participant:sarah@company.com"
```

Busca correos electrónicos de un remitente específico:

```
cb emails search "from:ceo@company.com"
```

Busca correos electrónicos en un rango de fechas:

```
cb emails search "project update after:2026-01-01 before:2026-04-01"
```

### Personas

Busca a una persona:

```
cb people search "Sarah Kerrigan"
```

### Empresas

Busca una empresa:

```
cb companies search "Acme"
```

### Etiquetas

Muestra todas las etiquetas:

```
cb tags list
```

Crea una etiqueta y luego define las etiquetas de una reunión por nombre o ID (separadas por comas; reemplazan sus etiquetas actuales):

```
cb tags create Renewals --color emerald
cb meetings update abc123 --tags Renewals,7
```

Cambia el nombre de una etiqueta o quita todas las etiquetas de una reunión:

```
cb tags update 7 --name "Q3 renewals"
cb meetings update abc123 --tags ""
```

### Soporte

Busca artículos de soporte de Circleback:

```
cb support search "recording in-person meetings"
```

## Acceso de escritura

Crear, actualizar y eliminar requiere acceso de escritura. Los inicios de sesión con el navegador anteriores a la v0.5.0 solo otorgaban acceso de lectura, así que vuelve a ejecutar `cb auth login`. Las claves de API de solo lectura no pueden hacer cambios, así que usa una clave de lectura y escritura de [**Configuración → Claves de API**](https://circleback.ai/settings?tab=api-access).

## Opciones

Todos los comandos admiten `--json` para obtener la salida en JSON sin procesar, lo que es útil para scripts, para canalizar datos a otras herramientas o para pasar datos a agentes de IA.

```
cb meetings search "standup" --last 7 --json
```