Capy

[Capy mascot]

Capy

One thing done well: your cap table.

Open-source cap table management for founders. Import from Pulley, manage equity, and take your data with you.

[CI] [License: AGPL-3.0] [Latest release]

Use Capy · Self-host · AI apps · Contribute · Roadmap · Changelog

[Capy's cap table: stakeholders, equity plans, fully diluted shares, and ownership]

Why Capy

We were Pulley customers too. We wanted a small, understandable product we could keep running, with code we could inspect and data we could export. So we built Capy.

This repository contains the web app, backend functions, equity calculations, import/export code, and deployment configuration. The hosted service at capyinc.com runs this application. Self-hosted installations do not require a Capy subscription.

What you can do

Screenshots use fictional companies and synthetic records.

Current scope

Capy is a young project with a working hosted product. We publish the implementation, checks, and limitations so you can evaluate it yourself.

The current release does not send documents for signature, move money, file taxes, provide 409A appraisals, or automate legal-document generation. Open Cap Table Format export is on the roadmap; exports today are Excel and CSV. Email verification/password recovery delivery and administrator-team invitations are not yet implemented.

Read supported workflows and boundaries and the Pulley import guide before migrating a company.

Use Capy from your AI app

Add https://capyinc.com/mcp to Claude, ChatGPT, Cursor, VS Code or another MCP client, sign in, and choose which companies the app can see. The app can read your cap table and, if you allow it, draft grants, exercises, cancellations, stakeholder updates and board consents. Nothing changes until an admin applies the draft in Capy. See connecting AI apps.

Run locally

Requirements: Bun 1.3.14, Node.js 24, and your own Convex project. Stripe and Cloudflare credentials are not needed for local development.

git clone https://github.com/zain/capy.gitcd capybun install --frozen-lockfilecp apps/web/.env.example apps/web/.env.localbun run dev:setup

Create or select your own Convex project. Once the CLI has written packages/backend/.env.local, use a second terminal from the repository root to configure its development environment:

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

The setup command waits for a successful push; if it reports missing environment variables, leave it running while setting them. Copy the deployment's .convex.cloud and .convex.site URLs into apps/web/.env.local, then:

bun run dev

Open localhost:3001, create an account, and import a workbook or create an empty company. See the development guide for the full environment reference and troubleshooting.

Checks

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

GitHub Actions runs these checks on pushes and pull requests, with a frozen lockfile and no production credentials. See CONTRIBUTING.md for the review and testing expectations.

Architecture

apps/web/               Routes, product UI, authentication, imports, exports, and the MCP serverpackages/backend/       Convex schema, functions, permissions, and file storagepackages/equity/        Shared equity calculations, validation, and modelingpackages/ui/            Shared UI componentspackages/infra/         Cloudflare deployment commandscripts/                Production build helperdocs/                   Setup, architecture, product scope, and migration guides

Read the architecture guide for data flow and access boundaries. The self-hosting guide covers deployment on your own Cloudflare and Convex accounts, updates, and backups. Running the Convex server itself on your infrastructure is not yet a tested deployment path for this repository.

Maintainers and support

Built by Zain and Sina. Zain maintains this repository; [email protected] reaches the team.

• Bugs and feature requests: open an issue.
• Setup and usage questions: Discussions.
• Private migration or account help: email us.
• Security vulnerabilities: use private vulnerability reporting, as described in SECURITY.md.

Please use synthetic examples in public issues. See SUPPORT.md for what to include in a report.

License and acknowledgments

Capy is licensed under GNU AGPL v3.0 (AGPL-3.0-only). Contributions use the same license. Dependency and asset licenses remain with their respective authors; see THIRD_PARTY_NOTICES.md.

Built with Better T Stack, TanStack, Convex, Better Auth, and shadcn/ui. Capy is an independent project and is not affiliated with Pulley or Carta.