Pular para o conteúdo principal

Visão Geral da Copera CLI

copera é a interface de linha de comando oficial do Copera. Use ela para trabalhar com boards, tabelas, linhas, docs, arquivos do drive, canais, notificações e dados do workspace — do seu terminal, de qualquer script ou de qualquer agente de IA.

A CLI foi desenhada para dois públicos:

  • Power users que preferem o teclado à interface, querem automatizar trabalho repetitivo ou rodar Copera de um shell remoto.
  • Agentes de IA de programação (Claude Code, Cursor, OpenCode, Codex e outros) que tomam ações reais e auditáveis no seu workspace por você.

Toda ação roda como o usuário dono do token — suas permissões são respeitadas, e cada mudança é totalmente reversível dentro do app.

Instalação​

macOS / Linux​

Rode no seu terminal:

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

Para instalar uma versão específica:

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

Por padrão, o instalador escreve o binário copera em /usr/local/bin/copera. Se esse diretório exigir permissões elevadas, o script pedirá sudo.

Windows​

Abra o PowerShell e rode:

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

Você não precisa rodar o PowerShell como Administrador — isso instala o copera.exe no seu perfil de usuário.

Feche e reabra o PowerShell, e então verifique a instalação:

copera version

Para fixar uma versão específica:

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

Instalação manual no Windows​

Se preferir baixar o arquivo você mesmo:

  1. Baixe o zip Windows AMD64 da versão desejada no CDN da Copera CLI.
  2. Extraia o copera.exe.
  3. Mova para um diretório no seu PATH, como %LOCALAPPDATA%\Microsoft\WindowsApps.
  4. Abra uma nova janela do PowerShell e rode copera version.

A partir do código​

Se você tem Go instalado:

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

Atualizar​

copera update

Use copera update --version 1.2.0 para instalar uma versão específica, ou copera update --force para pular a confirmação.

Primeira configuração​

Para a maioria das pessoas, o fluxo mais simples é:

copera auth login

A CLI imprime uma URL do Copera, abre no seu navegador padrão quando possível e pede para você colar o token gerado de volta no terminal. A URL impressa fica sempre disponível, então o mesmo fluxo funciona via SSH, no WSL ou em qualquer terminal onde o navegador não consegue abrir automaticamente.

Se você já tem um token, pode pular o navegador:

copera auth login --token=cp_pat_xxx

Para CI, scripts e pipelines de agentes, uma variável de ambiente é a abordagem mais limpa:

export COPERA_CLI_AUTH_TOKEN="cp_pat_xxx"

No Windows PowerShell:

$env:COPERA_CLI_AUTH_TOKEN = "cp_pat_xxx"

Experimente​

Depois de logar:

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

Para saída legível por máquina:

copera boards list --json

Próximos passos​

  • Autenticação — Tipos de token, fluxos de login e como a CLI resolve credenciais.
  • Comandos Comuns — Referência rápida para boards, linhas, docs, drive, canais, busca, notificações e mais.
  • Configuração — Perfis, IDs padrão, variáveis de ambiente e saída legível por máquina.