Comandos comunes

Esta página es una referencia rápida de los comandos copera más usados. Ejecuta copera <command> --help para ver la lista completa de flags y ejemplos de cualquier comando.

consejo

Muchos comandos aceptan --json para salida legible por máquina. La CLI también cambia automáticamente a JSON cuando stdout se canaliza a otro comando — consulta Configuración → Salida legible por máquina.

Auth

copera auth login                  # Flujo guiado por navegador
copera auth login --token=cp_pat_xxx
copera auth status                 # Muestra el perfil activo + origen del token
copera auth whoami                 # Muestra a quién pertenece el token
copera auth logout                 # Elimina la credencial guardada

Consulta Autenticación para más detalles sobre los tipos de token y los flujos de inicio de sesión.

Boards y tablas

copera boards list
copera boards list --search "roadmap"
copera boards get <board-id>

copera tables list --board <board-id>
copera tables list --board <board-id> --search "tasks"
copera tables get <table-id> --board <board-id>
copera tables export <table-id> --board <board-id> --view <view-id> \
  --format CSV -o out.csv

nota

copera bases es un alias integrado de copera boards — usa el que te resulte más natural.

Filas

La CLI expone todo el ciclo de vida de las filas — crear, leer, actualizar, eliminar — además de metadatos a nivel de fila como descripciones y comentarios.

copera rows list   --board <board-id> --table <table-id>
copera rows list   --board <board-id> --table <table-id> --search "oauth"
copera rows get    <row-id> --board <board-id> --table <table-id>

copera rows create --board <board-id> --table <table-id> \
  --data '{"columns":[{"columnId":"<column-id>","value":"Hello"}]}'

copera rows update <row-id> --board <board-id> --table <table-id> \
  --data '{"columns":[{"columnId":"<column-id>","value":"Updated"}]}'

copera rows delete <row-id> --board <board-id> --table <table-id> --force

Descripciones y comentarios

copera rows description       <row-id> --board <board-id> --table <table-id>
copera rows update-description <row-id> --board <board-id> --table <table-id> \
  --content "New description"

copera rows comment  <row-id> --board <board-id> --table <table-id> \
  --content "Looks good"
copera rows comments <row-id> --board <board-id> --table <table-id>

Soporte de stdin

rows create, rows comment y comandos similares aceptan entrada canalizada:

echo '{"columns":[{"columnId":"<column-id>","value":"Hello"}]}' \
  | copera rows create --board <board-id> --table <table-id>

echo "Looks good" \
  | copera rows comment <row-id> --board <board-id> --table <table-id>

Docs

Los comandos de docs requieren un Personal Access Token (cp_pat_...).

copera docs tree
copera docs tree --parent <doc-id>
copera docs search "keyword"
copera docs get <doc-id>
copera docs content <doc-id>

copera docs create --title "New Doc" --content "Initial content"
copera docs update <doc-id> --content "Replacement content"
copera docs update <doc-id> --operation append --content "More content"

copera docs metadata <doc-id> --title "New title"
copera docs delete   <doc-id> --force

Drive

Los comandos de drive requieren un Personal Access Token con acceso a drive.

copera drive tree
copera drive tree --parent <folder-id>
copera drive search "quarterly report"

copera drive get      <file-id>
copera drive download <file-id> -o report.pdf

copera drive upload ./report.pdf --parent <folder-id>
copera drive upload ./project/   --parent <folder-id>   # recursivo

copera drive mkdir "New Folder"

Las subidas admiten transferencia multiparte, tamaño de fragmento configurable, subida concurrente de partes, salida de progreso en terminales interactivas y subida recursiva de directorios.

Canales

copera channels list
copera channels list --search "deploy"
copera channels list --type text
copera channels list --kind dm --participant <user-id>

copera channels message send "Hello" --channel <channel-id>
copera channels direct-message send "Hello" --user <user-id>

# O desde stdin
echo "Deploy done" | copera channels message send --channel <channel-id>

Usa channels list o channels list --search para descubrir el ID del canal antes de automatizar. Los mensajes admiten Markdown — encabezados, negrita/cursiva, listas, bloques de código, enlaces.

Si tu versión de la CLI aún no expone un wrapper, el mismo descubrimiento está disponible a través de la API pública con q:

curl "$COPERA_API_URL/public/v1/chat/channels?q=deploy" \
  -H "Authorization: Bearer $COPERA_CLI_AUTH_TOKEN"

Espacio de trabajo, búsqueda y notificaciones

copera workspace info
copera workspace members
copera workspace teams

copera search "contract"
copera search "contract" --type document --type driveContent

copera notifications list
copera notifications read   <notification-id>
copera notifications unread <notification-id>
copera notifications delete <notification-id> --force

Caché y utilidades

copera cache status
copera cache clean

copera version
copera version --json

copera completion bash
copera completion zsh
copera completion fish

Canaliza la salida de completado al archivo de inicio de tu shell. Por ejemplo:

copera completion zsh >> ~/.zshrc

Luego reinicia tu shell o ejecuta source ~/.zshrc para activar el autocompletado con tabulador.