命令行工具

每个版本都提供 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

• -link 与 env pull——把仓库绑定到项目，并保持环境变量同步
• -psql、sql 与 connection-string——对单元开一个会话、执行单条查询，或把 URL 打印给别的工具
• -logs——在终端实时跟随 Postgres 和平台日志
• -status——项目此刻在做什么，包括它是不是在休眠
• -studio——打开已关联项目的 SQL 编辑器

• -preview——从分支创建、列出、重置和删除预览数据库
• -generate——从运行中的 schema 生成 TypeScript 类型、Zod 模式或 Drizzle 定义
• -schema dump 与 schema diff——抓取 schema，并查看两次抓取之间有什么变化
• -init drizzle——生成一份可用的 Drizzle 配置，池化安全的默认值已经设对
• -extensions——按单元启用并查看扩展目录

• -migrate codemod——把现有代码库从别家服务商的客户端上改写下来
• -migrate rls——把 Supabase 的行级安全策略转换成原生 PostgreSQL
• -migrate scan——找出把同一个键指向不同数据库的环境变量
• -import——把数据库搬过来，用 --follow 保持同步直到切换
• -doctor——检查项目配置，挑出那些会白白耗掉一晚上的错误

• -orgs、apikeys 与 audit——管理工作区，查看谁做了什么
• -webhooks 与 alerts——把平台事件接进你自己的系统
• -integrations——查看并管理与项目关联的平台集成
• -upgrade——按你自己的节奏在 Postgres 大版本之间迁移项目

每条命令都支持非交互标志，并可按需返回结构化输出，因此同一个二进制文件在终端、在 CI、在带 shell 的智能体手里都能用。认证方式是范围受限的 API 密钥，或由真人在浏览器里批准的设备登录。