Comandos Comuns

Esta página é uma referência rápida dos comandos copera mais usados. Rode copera <comando> --help para a lista completa de flags e exemplos de qualquer comando.

dica

Muitos comandos aceitam --json para saída legível por máquina. A CLI também muda automaticamente para JSON quando stdout é redirecionado para outro comando — veja Configuração → Saída legível por máquina.

Auth

copera auth login                  # Fluxo guiado pelo navegador
copera auth login --token=cp_pat_xxx
copera auth status                 # Mostra perfil ativo + fonte do token
copera auth whoami                 # Mostra a quem o token pertence
copera auth logout                 # Remove a credencial armazenada

Veja Autenticação para detalhes sobre tipos de token e fluxos de login.

Boards e tabelas

copera boards list
copera boards get <board-id>

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

observação

copera bases é um alias embutido para copera boards — use o que parecer mais natural.

Linhas

A CLI expõe o ciclo de vida completo das linhas — criar, ler, atualizar, deletar — mais metadados como descrições e comentários.

copera rows list   --board <board-id> --table <table-id>
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":"Atualizado"}]}'

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

Descrições e comentários

copera rows description       <row-id> --board <board-id> --table <table-id>
copera rows update-description <row-id> --board <board-id> --table <table-id> \
  --content "Nova descrição"

copera rows comment  <row-id> --board <board-id> --table <table-id> \
  --content "Tá bom"
copera rows comments <row-id> --board <board-id> --table <table-id>

Suporte a stdin

rows create, rows comment e comandos parecidos aceitam entrada por pipe:

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

echo "Tá bom" \
  | copera rows comment <row-id> --board <board-id> --table <table-id>

Docs

Comandos de docs exigem um Personal Access Token (cp_pat_...).

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

copera docs create --title "Novo Doc" --content "Conteúdo inicial"
copera docs update <doc-id> --content "Conteúdo de substituição"
copera docs update <doc-id> --operation append --content "Mais conteúdo"

copera docs metadata <doc-id> --title "Novo título"
copera docs delete   <doc-id> --force

Drive

Comandos de drive exigem um Personal Access Token com acesso ao drive.

copera drive tree
copera drive tree --parent <folder-id>
copera drive search "relatório trimestral"

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

copera drive upload ./relatorio.pdf --parent <folder-id>
copera drive upload ./projeto/      --parent <folder-id>   # recursivo

copera drive mkdir "Nova Pasta"

Uploads suportam transferência multipart, tamanho de chunk configurável, uploads simultâneos de partes, saída de progresso em terminais interativos e upload recursivo de diretórios.

Canais

copera channels message send "Olá" --channel <channel-id>

# Ou via stdin
echo "Deploy concluído" | copera channels message send --channel <channel-id>

Mensagens suportam Markdown — headings, negrito/itálico, listas, code blocks, links.

Workspace, busca e notificações

copera workspace info
copera workspace members
copera workspace teams

copera search "contrato"
copera search "contrato" --type document --type driveContent

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

Cache e utilidades

copera cache status
copera cache clean

copera version
copera version --json

copera completion bash
copera completion zsh
copera completion fish

Direcione a saída do completion para o arquivo de inicialização do seu shell. Por exemplo:

copera completion zsh >> ~/.zshrc

Depois reinicie o shell ou rode source ~/.zshrc para ativar o autocompletar.