Capy

Capy

专注做好一件事：管理你的股权表。

面向创始人的开源股权表管理工具。可从 Pulley 导入、管理股权，并随时导出你的数据。

使用 Capy · 自托管 · AI 应用 · 参与贡献 · 路线图 · 更新日志

为什么选择 Capy

我们也曾是 Pulley 的客户。我们想要一款小巧、易懂、可以持续运行的产品，能够查看其代码并导出数据。因此，我们构建了 Capy。

此仓库包含 Web 应用、后端函数、股权计算、导入和导出代码，以及部署配置。capyinc.com 上的托管服务运行的就是此应用。可自托管的安装版本无需订阅 Capy。

可以用它做什么

工作流	功能
导入股权表	注册前预览详细的 Pulley Excel 导出文件；保存前查看核对结果和警告；也可以单独导入联系人。
管理股权	跟踪利益相关者、股份、期权、SAFEs、股份类别和股权计划。记录更正、期权行权和注销，并保留活动历史记录。
了解所有权	查看完全稀释后的所有权、计划预留股份和支持的按月归属计划。搜索、排序和筛选股权表。
模拟融资	对比定价轮融资与融资前和融资后 SAFEs、估值上限及折扣的稀释情况；保存方案。
与利益相关者分享	邀请利益相关者查看自己的持股；邀请只能认领一次，也可撤销。
保存记录	存储文档，并保存审批、要约和沟通草稿。
导出数据	将股权表下载为 Excel，将各个表格下载为 CSV。
通过 AI 应用使用	通过 MCP 将 Claude、ChatGPT、Cursor 或其他 AI 应用连接到股权表，以便读取数据并起草变更，供管理员应用。

查看融资和 SAFE 页面

模拟下一轮融资

跟踪 SAFEs

截图中使用的均为虚构公司和合成记录。

当前范围

Capy 是一个仍处于早期阶段的项目，已有可用的托管产品。我们公开实现方式、检查项和限制，方便你自行评估。

当前版本不会发送文件供签署、转移资金、申报税务、提供 409A 估值，也不会自动生成法律文件。开放股权表格式导出已列入路线图；目前支持导出为 Excel 和 CSV。电子邮件验证和密码恢复邮件的发送功能，以及管理员团队邀请功能，尚未实现。

迁移公司前，请先阅读支持的工作流和边界及Pulley 导入指南。

在 AI 应用中使用 Capy

将 https://capyinc.com/mcp 添加到 Claude、ChatGPT、Cursor、VS Code 或其他 MCP 客户端，登录并选择应用可查看哪些公司。应用可以读取你的股权表；如果你允许，也可以拟定授予、行权、取消、利益相关者更新和董事会同意书。只有管理员在 Capy 中应用草稿后，变更才会生效。请参阅连接 AI 应用。

本地运行

要求： Bun 1.3.14、Node.js 24，以及你自己的 Convex 项目。本地开发不需要 Stripe 和 Cloudflare 凭据。

git clone https://github.com/zain/capy.git
cd capy
bun install --frozen-lockfile
cp apps/web/.env.example apps/web/.env.local
bun run dev:setup

创建或选择你自己的 Convex 项目。CLI 写入 packages/backend/.env.local 后，在仓库根目录打开另一个终端，配置开发环境：

cd packages/backend
bunx convex env set SITE_URL http://localhost:3001
bunx convex env set BETTER_AUTH_SECRET "$(openssl rand -hex 32)"
bunx convex env set CAPY_SELF_HOSTED true
cd ../..

设置命令会等待成功推送；如果提示缺少环境变量，请让命令继续运行，同时设置这些变量。将部署的 .convex.cloud 和 .convex.site URL 复制到 apps/web/.env.local，然后：

bun run dev

打开 localhost:3001，创建账户，然后导入工作簿或创建空公司。完整的环境参考和故障排查信息，请参阅开发指南。

检查

bun run check    # formatting, lint, production build, and TypeScript
bun run test     # import/export, calculations, billing, and webhook tests
bun audit        # known dependency vulnerabilities

GitHub Actions 会在推送和拉取请求时运行这些检查，使用冻结的锁文件，且不使用生产凭据。有关评审和测试要求，请参阅 CONTRIBUTING.md。

架构

部分	技术
Web 应用	React、TanStack Start、TypeScript
数据库和服务器函数	Convex
身份验证	Better Auth 和 Convex 适配器
计算和验证	Decimal.js 和 Zod
Excel 导入/导出	ExcelJS
工具链	Bun 和 Vite+
托管 Web 部署	Cloudflare Workers

apps/web/               Routes, product UI, authentication, imports, exports, and the MCP server
packages/backend/       Convex schema, functions, permissions, and file storage
packages/equity/        Shared equity calculations, validation, and modeling
packages/ui/            Shared UI components
packages/infra/         Cloudflare deployment command
scripts/                Production build helper
docs/                   Setup, architecture, product scope, and migration guides

有关数据流和访问边界，请参阅架构指南。自托管指南介绍如何在你自己的 Cloudflare 和 Convex 账户上部署、更新和备份。在自己的基础设施上运行 Convex 服务器本身，目前还不是此仓库经过测试的部署方式。

维护者和支持

由 Zain 和 Sina 构建。Zain 维护此仓库；可通过 [email protected] 联系团队。

• Bug 和功能请求：提交 issue。
• 设置和使用问题：Discussions。
• 私密迁移或账户帮助：给我们发送电子邮件。
• **安全漏洞：**请按照 SECURITY.md 中的说明，使用私密漏洞报告。

请在公开 issue 中使用合成示例。报告内容要求请参阅 SUPPORT.md。

许可证与致谢

Capy 采用 GNU AGPL v3.0 许可（AGPL-3.0-only）。贡献内容采用相同许可。依赖项和资源的许可证仍归各自作者所有；请参阅 THIRD_PARTY_NOTICES.md。

本项目基于 Better T Stack、TanStack、Convex、Better Auth 和 shadcn/ui 构建。Capy 是一个独立项目，与 Pulley 或 Carta 无关联。