개발자용

CLI

수명주기 전체를 처리하는 단일 바이너리. Go로 작성했고 런타임이 없으며 앱의 언어에 의존하지 않습니다.

01

설치

릴리스마다 macOS·Linux·Windows용 사전 빌드 바이너리와 체크섬을 제공합니다. 함께 설치할 런타임은 없습니다.

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

# Everything else follows from there
capydb --help

02

매일

  • -link와 env pull — 저장소를 프로젝트에 연결하고 환경 변수를 계속 맞춰 둡니다
  • -psql, sql, connection-string — 셀에 셸을 열거나, 단발 쿼리를 실행하거나, 다른 도구용 URL을 출력합니다
  • -logs — Postgres와 플랫폼 로그를 터미널에서 실시간으로 따라갑니다
  • -status — 프로젝트가 지금 무엇을 하고 있는지, 잠들었는지까지
  • -studio — 연결된 프로젝트의 SQL 편집기를 엽니다

03

배포할 때

  • -preview — 브랜치에서 프리뷰 데이터베이스를 만들고 조회·초기화·삭제
  • -generate — 실행 중인 스키마에서 TypeScript 타입, Zod 스키마, Drizzle 정의 생성
  • -schema dump와 schema diff — 스키마를 캡처하고 두 캡처 사이의 변경을 확인
  • -init drizzle — 풀러 안전 기본값이 이미 올바른, 동작하는 Drizzle 설정을 만들어 줍니다
  • -extensions — 셀 단위로 확장 카탈로그를 켜고 살펴봅니다

04

들어오고 나가기

  • -migrate codemod — 기존 코드베이스를 다른 제공자의 클라이언트에서 떼어냅니다
  • -migrate rls — Supabase의 행 수준 보안 정책을 순수 PostgreSQL로 변환합니다
  • -migrate scan — 같은 키가 서로 다른 데이터베이스를 가리키는 환경 변수를 찾아냅니다
  • -import — 데이터베이스를 옮겨 옵니다. --follow로 전환 시점까지 동기화를 유지합니다
  • -doctor — 하룻밤을 잡아먹는 종류의 실수를 프로젝트 설정에서 잡아냅니다

05

워크스페이스

  • -orgs, apikeys, audit — 워크스페이스를 관리하고 누가 무엇을 했는지 확인
  • -webhooks와 alerts — 플랫폼 이벤트를 자체 시스템으로 흘려보냅니다
  • -integrations — 프로젝트에 연결된 플랫폼 연동을 확인하고 관리
  • -upgrade — 원하는 일정에 맞춰 Postgres 메이저 버전 사이를 이동

06

스크립트와 에이전트를 위해

모든 명령이 비대화형 플래그를 지원하고 요청하면 구조화된 출력을 돌려주므로, 같은 바이너리가 터미널에서도 CI에서도 셸을 가진 에이전트의 손에서도 동작합니다. 인증은 범위가 제한된 API 키이거나, 사람이 브라우저에서 승인하는 기기 로그인입니다.