Saltar al contenido principal

Resumen 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, canales, notificaciones y datos del espacio de trabajo — desde tu terminal o desde cualquier script o agente de IA.

La CLI está diseñada 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, OpenCode, Codex y otros) que realizan acciones reales y auditables en tu espacio de trabajo 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 app.

Instalación​

macOS / Linux​

Ejecuta esto en tu terminal:

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

Para instalar una versión específica:

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

Por defecto, el instalador escribe el binario copera en /usr/local/bin/copera. Si ese directorio requiere permisos elevados, el script pedirá sudo.

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 la instalación:

copera version

Para fijar una versión específica:

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

Instalación manual en Windows​

Si prefieres descargar el archivo tú mismo:

  1. Descarga el zip de Windows AMD64 de la versión que quieras desde el CDN de Copera CLI.
  2. Extrae copera.exe.
  3. Muévelo a un directorio de tu PATH, como %LOCALAPPDATA%\Microsoft\WindowsApps.
  4. 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​

copera update

Usa copera update --version 1.2.0 para instalar una versión específica, o copera update --force para omitir la confirmación.

Configuración inicial​

Para la mayoría de las personas, el flujo más simple es:

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, así 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, puedes saltarte el navegador:

copera auth login --token=cp_pat_xxx

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

export COPERA_CLI_AUTH_TOKEN="cp_pat_xxx"

En Windows PowerShell:

$env:COPERA_CLI_AUTH_TOKEN = "cp_pat_xxx"

Pruébalo​

Una vez que hayas iniciado sesión:

copera auth status
copera boards list
copera docs tree
copera search "onboarding"

Para salida legible por máquina:

copera boards list --json

Próximos pasos​

  • Autenticación — Tipos de token, flujos de inicio de sesión y cómo la CLI resuelve las credenciales.
  • Comandos comunes — Referencia rápida de boards, filas, docs, drive, canales, búsqueda, notificaciones y más.
  • Configuración — Perfiles, IDs predeterminados, variables de entorno y salida legible por máquina.