The Fairmint CLI lets you pull your company's cap table data straight from your computer's terminal, with no need to open the web app. In a few commands you can log in, pick your company, and export a ready-to-share file of your equity grants, stock, warrants, or SAFEs.

The CLI is the command-line version of Cap Table AI. It installs two commands that do the same thing: captable-ai and the shorter cai. You can use either one throughout this guide.

Common uses:

You need three things:

Copy this command into your terminal and press Enter:

Wait for the install to finish before moving on. Run each command in this guide one at a time, rather than pasting several at once.

To update later, run the same command again. Adding @latest makes sure you always get the newest version.

Run:

A browser window opens. Sign in with the email you use for Fairmint, accept the terms, and click Finish in browser. Then return to your terminal.

To confirm you're logged in, run:

This shows the email you're signed in with, when your session expires, and your active company. Sessions refresh on their own, so you usually only log in once.

To sign out or switch to a different account, run captable-ai logout, then log in again.

Every command runs against one active company. First, list the companies you can access:

Then set the one you want, using its name (in quotes) or its ID from the list:

To check which company is active at any time, run captable-ai company current.

The grants export gives you one row per grant, ready to open in Excel or Google Sheets. Exports are read-only, so running them never changes your cap table.

Each row includes the holder's name and contact details, quantity, dollar amount, status, accepted on date, cliff and vesting length (in months), effective date, award type (ISO, NSO, or RSU), series, and plan.

Use either --csv or --json, not both. Without --include-pending, the export lists your committed cap table only.

The same options work for your other registers: cai export stock, cai export warrants, and cai export convertibles. For convertibles, add --type SAFE or --type NOTE to filter by type.

These are the commands most useful day to day. For the complete list, run captable-ai commands. Every command works with captable-ai or cai.

Pro forma scenarios never change your actual cap table.

Tip: add --json to most commands to get structured output, which is handy if you're using the CLI with an AI assistant or a script.

I get "command not found: captable-ai". The CLI isn't installed yet, or the install didn't finish. Run the install command from Step 1, wait for it to complete, then try again. If it still fails, close and reopen your terminal.

I'm told I'm not logged in, or my session expired. Run captable-ai login again.

My company doesn't show up in company list. Run captable-ai auth status to check which email you're signed in with. If it's the wrong one, run captable-ai logout, then log in with the email you use for Fairmint. You also need owner or admin access to the company.

I can't find my exported file. Files save to the folder your terminal was in when you ran the command. Run cd Downloads before exporting to save files there.

My Excel download link stopped working. Links expire after 1 hour. Run the export again for a fresh link, or use --csv --output to save a file directly.

Some grants are missing from my export. Add --include-pending to include grants not yet committed to your cap table. Grants sent through Fairmint that are still waiting on a signature won't appear until they're signed.

Can I choose which columns are included, or schedule exports? Not yet. Each register has a fixed set of columns, and each export is a one-time run.

We're happy to walk you through it. Message us through the chat bubble in the Fairmint app, or email contact@fairmint.co.