Sally Sold CLI

Generate beautiful invoice PDFs from your terminal.

Install

npm install -g sallysold

Requires Node 18 or newer.

Get started

1. Sign in at sallysold.com and mint an API key at sallysold.com/settings/api-keys.
2. Sign in:

   sallysold login

3. Create your first invoice:

   sallysold create

The first invoice walks you through everything — business details, client, line items, template. After that, your business and clients are remembered and future invoices auto-suggest them.

API key scopes

When you mint a key, you pick one of three access levels:

| Scope | Lets you | When to pick it | | --- | --- | --- | | PDF only | sallysold generates PDFs from data you pass in directly | CI scripts that build invoices from external data | | PDF + read | pdf + read your saved business, clients, invoice history | Scripts that read your account but don't change it | | Full access (default) | Everything — also save new invoices and clients | The CLI's interactive create flow needs this |

The mint UI defaults to "Full access". Pick a narrower scope only if you want a key locked down for a specific automation.

Commands

| Command | What it does | | --- | --- | | sallysold login | Sign in with an API key | | sallysold logout | Remove the stored API key | | sallysold whoami | Show the currently signed-in account | | sallysold templates | List available invoice templates | | sallysold create | Create a new invoice (interactive) | | sallysold quick | Fast path for repeat invoicing to a saved client | | sallysold resume | Pick up an interrupted create flow where you left off | | sallysold invoices | List your invoice history | | sallysold duplicate <number> | Re-invoice a past client with one command | | sallysold open | Open the most recently generated PDF | | sallysold doctor | Run self-diagnostics (Node, config, API, key) |

create options

• -o, --output <path> — save the PDF to a specific path (skips the save prompt; ideal for scripting)

quick

For when you've already invoiced this client before. Pick a saved client, pick a saved business, paste or type a one-line items string (e.g. "Design: 10h @ 150"), pick a net-N due date — done. Skips the long-form wizard.

sallysold quick

quick and resume accept the same -o, --output <path> flag as create.

resume

create autosaves a draft as you go. If you exit (intentionally or not), resume picks it up from the last step you completed.

sallysold resume

duplicate <invoice-number>

Looks up a past invoice by its user-facing number (e.g. INV-2026-04-001), prompts for new dates and a new invoice number, and regenerates with the same business, client, template, and line items.

sallysold duplicate INV-2026-04-001

doctor

Runs a battery of self-checks and prints a status report: Node version, config file presence and permissions, API URL reachability, and whether your stored key authenticates. Use this first when something isn't working.

sallysold doctor

Config

Your API key is stored at ~/.sallysold/config.json with 0600 permissions.

You can override the API key with an env var:

SALLYSOLD_API_KEY=sk_live_... sallysold create

For self-hosted or staging endpoints:

SALLYSOLD_API_URL=https://staging.example.com sallysold create

Security

API keys are minted once and shown to you on-screen. Sally Sold stores only a sha256 hash — there's no way to recover a key after you close the modal. Lost a key? Revoke it from /settings/api-keys and mint a new one.

License

MIT