Saltar al contenido principal

Visión general de Copera CLI

copera es la interfaz de línea de comandos oficial de Copera. Úsala para trabajar con boards, tablas, filas, docs, archivos de drive, channels, notificaciones y datos del workspace, directamente desde tu terminal, un script o un agente de programación con IA.

La CLI está pensada para dos públicos:

  • Usuarios avanzados que prefieren el teclado a la interfaz, quieren automatizar tareas repetitivas o ejecutar Copera desde una shell remota.
  • Agentes de programación con IA (Claude Code, Cursor, Codex y otros) que realizan acciones reales y auditables en tu workspace en tu nombre.

Cada acción se ejecuta como el usuario detrás del token: se respetan tus permisos y todo cambio es totalmente reversible en la aplicación.

información

La CLI envuelve la Copera Public API. Su URL base es https://api.copera.ai/public/v1. Si prefieres llamar a la API directamente, o conectar un cliente de IA por MCP, consulta Visión general de MCP.

Instalación​

macOS / Linux​

Ejecuta esto en tu terminal:

curl -fsSL https://cli.copera.ai/install.sh | bash

De forma predeterminada, el instalador escribe el binario copera en /usr/local/bin/copera. Si ese directorio requiere permisos elevados, el script solicita sudo.

Para instalar una versión específica:

VERSION=0.1.0 curl -fsSL https://cli.copera.ai/install.sh | bash

Windows​

Abre PowerShell y ejecuta:

irm https://cli.copera.ai/install.ps1 | iex

No necesitas ejecutar PowerShell como Administrador: esto instala copera.exe en tu perfil de usuario. Cierra y vuelve a abrir PowerShell, luego verifica:

copera version

Para fijar una versión específica:

$env:VERSION = "0.1.0"; irm https://cli.copera.ai/install.ps1 | iex

Si prefieres instalar manualmente: descarga el zip de Windows AMD64 de la versión que quieras desde el CDN de Copera CLI, extrae copera.exe, muévelo a un directorio en tu PATH (como %LOCALAPPDATA%\Microsoft\WindowsApps), luego abre una nueva ventana de PowerShell y ejecuta copera version.

Desde el código fuente​

Si tienes Go instalado:

go install github.com/copera/copera-cli/cmd/copera@latest

Actualización​

Actualiza una instalación existente en cualquier momento:

copera update                  # actualiza a la última versión
copera update --version 1.2.0  # fija una versión específica
copera update --force          # omite el aviso de confirmación

Inicio rápido​

Inicia sesión. El flujo más sencillo abre un navegador e imprime una URL que puedes usar en cualquier lugar:

copera auth login

La CLI imprime una URL de Copera, la abre en tu navegador predeterminado cuando es posible y te pide que pegues el token generado de vuelta en la terminal. La URL impresa siempre está disponible, por lo que el mismo flujo funciona por SSH, en WSL o en cualquier terminal donde el navegador no se abra automáticamente.

Si ya tienes un token, omite el navegador:

copera auth login --token=cp_pat_xxx

Para CI, scripts y pipelines de agentes, una variable de entorno es lo más limpio:

export COPERA_CLI_AUTH_TOKEN="cp_pat_xxx"

Confirma la sesión:

copera auth status     # perfil activo + de dónde vino el token
copera auth whoami     # a quién pertenece el token

Prueba algunos comandos:

copera boards list
copera docs tree
copera search "onboarding"

Para una salida legible por máquina, agrega --json:

copera boards list --json

Consulta Autenticación para conocer los tipos de token y los flujos de inicio de sesión, y Comandos para la referencia completa de comandos.

Formatos de salida​

La CLI está diseñada para funcionar bien tanto en terminales interactivas como en pipelines automatizados.

  • Cuando stdout es un TTY, la salida es una tabla coloreada y legible para humanos.
  • Cuando stdout no es un TTY (canalizado a otro comando, redirigido a un archivo o ejecutado en CI), la salida es JSON de forma predeterminada: segura para agentes por defecto.
  • --json fuerza la salida JSON incluso en una terminal.
  • --output acepta auto (predeterminado), json, table o plain.
  • --quiet / -q suprime los mensajes informativos.
  • --no-input (y CI=true) desactivan los avisos interactivos.
copera boards list                 # tabla en una terminal, JSON cuando se canaliza
copera boards list --json | jq '.[].name'
copera boards list --output plain  # un valor por línea, para scripts

Los errores se emiten en stderr como JSON estructurado, para que la salida de éxito se mantenga limpia:

{"error":"resource_not_found","message":"Board 'abc123' not found","suggestion":"Run 'copera boards list' to see accessible boards","transient":false}

transient: true significa que el error es reintentable; false significa que reintentar no ayudará.

Códigos de salida​

Los códigos de salida son estables, por lo que los scripts pueden ramificarse en ellos de forma segura:

CódigoSignificado
0OK
1Error genérico
2Error de uso (flags incorrectos, argumentos faltantes)
3No encontrado
4Error de autenticación / permiso denegado
5Conflicto (p. ej. un recurso que ya existe)
6Límite de tasa alcanzado

Variables de entorno​

VariableDescripción
COPERA_CLI_AUTH_TOKENToken de API. Anula todo archivo de configuración.
COPERA_PROFILENombre del perfil de configuración activo (predeterminado: default).
COPERA_SANDBOXEstablece en 1 para apuntar a la API de desarrollo (api-dev.copera.ai).
COPERA_NO_UPDATE_CHECKEstablece en 1 para desactivar las comprobaciones de versión en segundo plano.
CIEstablece en true para desactivar los avisos interactivos y las comprobaciones de actualización.
NO_COLORDesactiva la salida de color ANSI.

Consulta Configuración para la lista completa, incluyendo perfiles y opciones del archivo de configuración.

Explora la documentación​

Autenticación

Tipos de token, los flujos de inicio de sesión y cómo la CLI resuelve las credenciales.

Comandos

La referencia completa de comandos: boards, filas, docs, drive, channels y más.

Configuración

Perfiles, IDs predeterminados, variables de entorno y salida legible por máquina.

Servidor MCP

Conecta clientes de IA a la misma Public API mediante el Model Context Protocol.

Relacionado​