Repository navigation
CoinPay CLI v0.9.0 — your money in the terminal
coinpay finances opens your money in the terminal.
Seven screens, switched with 1-7 or Tab.
Overview puts gross volume, commission paid, processor fees, refunds and net earnings next to your bank position and cashflow, with invoices, escrow and payouts alongside a volume-versus-commission graph and a live feed.
Bank & Cards lists every account linked through SimpleFIN or Plaid with its balance, what each institution is owed, and when the feed last synced.
Ledger is the transaction list with categories and a spend breakdown.
Crypto and Cards each show their payments with fees, net and status.
Invoices & Escrow shows what is outstanding, what is overdue and what settled.
Debt & Income is new in this release: debt against income over a rolling six months, with debt-to-income, debt-service ratio, months of cover, credit utilisation, payoff months, per-account debt shares, detected recurring charges and a business-versus-personal split. It uses a fixed six-month lookback rather than the dashboard window, because recurring detection has to see a charge three times before it can name a cadence, and a 30-day window would report "no recurring obligations" as though that were a fact about your finances rather than about the window.
The dashboard refreshes on a timer and subscribes to the payments event stream, so a crypto payment appears the moment it is detected. Bank sync stays a keypress, s, because the bank bridge allows roughly 24 pulls a day. r refreshes, w cycles the window across 7, 30, 90 and 365 days, p pauses, ? shows help.
For scripts and for Node older than 22.6 there are plain-text equivalents: coinpay finances summary, accounts, ledger, connections and sync, each with --json.
The SDK gains a finances module, importable as @profullstack/coinpay/finances, wrapping the finance routes and exposing a pure buildFinanceSnapshot that computes the headline figures without touching the network.
npm install -g @profullstack/coinpay
coinpay login
coinpay finances
Bank data needs the merchant session from coinpay login. Business API keys are refused there on purpose. The dashboard needs Node 22.6 or newer; the installer now provisions Node 22.