Para desenvolvedores

CLI

Um único binário que cobre todo o ciclo de vida. Escrito em Go, sem runtime e sem depender da linguagem do seu app.

01

Instalação

Binários prontos para macOS, Linux e Windows em cada release, com somas de verificação. Nenhum runtime para instalar junto.

# Link a repository to a project and write .env.local
capydb link
capydb env pull

# Everything else follows from there
capydb --help

02

No dia a dia

  • -link e env pull - ligar o repositório a um projeto e manter as variáveis de ambiente sincronizadas
  • -psql, sql e connection-string - abrir uma sessão na célula, rodar uma única consulta ou imprimir a URL para outra ferramenta
  • -logs - acompanhar ao vivo os logs do Postgres e da plataforma no terminal
  • -status - o que o projeto está fazendo agora, inclusive se está dormindo
  • -studio - abrir o editor SQL do projeto ligado

03

Na hora de entregar

  • -preview - criar, listar, redefinir e excluir bancos de preview a partir de uma branch
  • -generate - tipos TypeScript, esquemas Zod ou definições Drizzle a partir do esquema em execução
  • -schema dump e schema diff - capturar o esquema e ver o que mudou entre duas capturas
  • -init drizzle - gerar uma configuração Drizzle funcional já com os padrões seguros para o pooler
  • -extensions - habilitar e consultar o catálogo de extensões por célula

04

Entrar e sair

  • -migrate codemod - reescrever uma base de código existente para sair do cliente de outro provedor
  • -migrate rls - converter políticas de segurança em nível de linha do Supabase para PostgreSQL puro
  • -migrate scan - encontrar variáveis de ambiente que apontam a mesma chave para bancos diferentes
  • -import - trazer um banco, com --follow para manter sincronizado até a virada
  • -doctor - revisar a configuração de um projeto atrás dos erros que custam uma noite

05

Workspace

  • -orgs, apikeys e audit - administrar o workspace e ver quem fez o quê
  • -webhooks e alerts - levar eventos da plataforma para os seus próprios sistemas
  • -integrations - consultar e administrar as integrações de plataforma ligadas a um projeto
  • -upgrade - mover um projeto entre versões maiores do Postgres no seu ritmo

06

Feita para scripts e agentes

Todo comando aceita flags não interativas e devolve saída estruturada quando pedido, então o mesmo binário serve no terminal, na CI e nas mãos de um agente com shell. A autenticação é uma chave de API restrita ou um login de dispositivo que a pessoa aprova no navegador.