Skip to content
Back to search

fungible

Terminal UI and Desktop GUI for personal finance — Plaid sync, CSV import, AI assistant, and MCP server

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tomfunk--fungible/badge.svg)](/listings/tomfunk--fungible)

HTML

<a href="/listings/tomfunk--fungible"><img src="/api/listings/tomfunk--fungible/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Terminal UI

**Homebrew (recommended)**

brew tap tomfunk/fungible
brew install fungible
fungible --setup     # first-time setup wizard
fungible --version   # print installed version
fungible

**From source** (Node.js 22+, also works on Linux/WSL)

git clone https://github.com/tomfunk/fungible
cd fungible
npm install
npm run dev -- --setup   # first-time setup
npm run dev

Desktop GUI

Download an installer from the [latest release](https://github.com/tomfunk/fungible/releases/latest) (macOS arm64, Windows x64, Linux x64), or run from source:

npm install
npm run gui

The GUI reads/writes the same `~/.fungible/` database as the TUI — switch freely.

For first-launch caveats on the un-notarized installers (Gatekeeper, SmartScreen) and packaging details, see [`docs/gui.md`](docs/gui.md).

Storage

Data and config live at `~/.fungible/` (override with `$FUNGIBLE_DATA_DIR`). Plaid access tokens are encrypted at rest using a key file at `~/.fungible/key` — do not delete this file or you will need to re-link your accounts. A free [Plaid](https://plaid.com) developer account (sandbox tier) is enough.

Banks that use OAuth (Chase, Amex, Wells Fargo, ...)

These banks send you to their own site to sign in. In a desktop browser Plaid opens that site in a popup, which needs no setup. If Link fails before you reach the bank, the page shows Plaid's error code and Link session ID. In production, a code like `INSTITUTION_REGISTRATION_REQUIRED` means your Plaid team is not yet enabled for that bank: check [US OAuth institutions](https://dashboard.plaid.com/settings/compliance/us-oauth-institutions) in the Plaid Dashboard (Chase also requires the security questionnaire).

If popups are not an option, fungible can take the bank's full-page redirect instead. Plaid accepts `http://localhost` redirect URIs only in sandbox; in production the redirect must be HTTPS, so the local link server needs a certificate for `localhost`, for example from [mkcert](https://github.com/FiloSottile/mkcert):

mkcert -install   # adds mkcert's local CA to your system trust store (once)
mkcert -cert-file ~/.fungible/localhost.pem -key-file ~/.fungible/localhost-key.pem localhost

Then add to `~/.fungible/.env`, using full paths (`~` is not expanded there):

PLAID_REDIRECT_URI=https://localhost:4747/oauth-return
FUNGIBLE_LINK_TLS_CERT=/Users/you/.fungible/localhost.pem
FUNGIBLE_LINK_TLS_KEY=/Users/you/.fungible/localhost-key.pem

and register the same URI, exactly as written, under Allowed redirect URIs on the Plaid Dashboard's [Developers > API](https://dashboard.plaid.com/developers/api) page. The link server then listens on that port, over HTTPS. Leave `PLAID_REDIRECT_URI` unset to keep the default behaviour.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 158 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <img src="logo.png" alt="fungible" width="400" />
  2. [![CI](https://github.com/tomfunk/fungible/actions/workflows/ci.yml/badge.svg)](https://github.com/tomfunk/fungible/actions/workflows/ci.yml)
  3. Personal finance, keyboard-first. Available as a **terminal UI** or a **desktop app** — both running over the same local data: Plaid sync, CSV import, categorize, tag, search, analyze. Plus an MCP server so Claude can read and manage it for you.
  4. <img src="docs/screenshots/demo.gif" alt="fungible TUI demo" width="720" />
  5. <img src="docs/screenshots/demo-gui.gif" alt="fungible GUI demo" width="720" />
  6. <details>
  7. <summary>Screenshots</summary>
  8. ### Terminal UI
  9. | | |
  10. |---|---|
  11. | ![Dashboard](docs/screenshots/dashboard.png) | ![Transactions](docs/screenshots/transactions.png) |
  12. | ![Trends](docs/screenshots/trends.png) | ![Net Worth](docs/screenshots/net-worth.png) |
  13. | ![Tags](docs/screenshots/tags.png) | ![Financial Health](docs/screenshots/financial-health.png) |
  14. | ![Rules](docs/screenshots/rules.png) | ![Accounts](docs/screenshots/accounts.png) |
  15. ### Desktop GUI
  16. | | |
  17. |---|---|
  18. | ![Dashboard](docs/screenshots/gui/dashboard.png) | ![Transactions](docs/screenshots/gui/transactions.png) |
  19. | ![Trends](docs/screenshots/gui/trends.png) | ![Net Worth](docs/screenshots/gui/networth.png) |
  20. | ![Tags](docs/screenshots/gui/tags.png) | ![Financial Health](docs/screenshots/gui/health.png) |
  21. | ![Rules](docs/screenshots/gui/rules.png) | ![Accounts](docs/screenshots/gui/accounts.png) |
  22. </details>
  23. ## Features
  24. - **Plaid sync** — connect bank accounts and pull transactions automatically; 15-min debounce with force-sync option
  25. - **CSV import** — import statement exports from any bank with flexible column mapping
  26. - **Balance history import** — load past balances from a `date,account,balance` CSV to fill in net worth history
  27. - **Manual assets** — track a house, car, or other asset by name and value
  28. - **Category & name rules** — substring or regex rules that auto-categorize and rename transactions; survives re-syncs
  29. - **Spending flexibility** — tag categories as fixed / flexible / discretionary; see breakdown on Dashboard
  30. - **Scorecard** — categories flagged over / under the typical month against a 12-month median baseline, with a net verdict and optional delta columns (prior period, same period last year, 12-month average); heat-map coloring
  31. - **Tags** — label transactions across accounts (trips, projects, events) and view summaries by tag
  32. - **Net worth** — balance history with asset/liability breakdown; by account or by type; import earlier balances from CSV
  33. - **Financial health** — cash and liquid runway, FIRE number and progress, years to retirement with adjustable assumptions
  34. - **Trends** — bar charts for expenses, income, net, or any category; per-range aggregation
  35. - **Regex search** — shared across Dashboard, Transactions, and Trends
  36. - **Dedup review** — review and remove CSV transactions that duplicate Plaid imports
  37. - **MCP server + HTTP API** — Claude (or any script) can read and manage your finances
  38. - **Daily backups** — kept at `~/.fungible/backups/`, last 7 by default (configurable via `FUNGIBLE_BACKUP_DAYS`)
  39. ## Try it (no account needed)
  40. ```bash
  41. fungible --demo
  42. ```
  43. Spins up a fully pre-loaded instance with fake accounts, transactions, tags, and rules — completely isolated from any real data. Good for exploring before connecting a bank.
  44. In the desktop app, pick **"Try Demo Mode"** from the app menu (macOS) or Help menu (Windows/Linux) — the app relaunches with the same isolated demo dataset.
  45. ## Install
  46. ### Terminal UI
  47. **Homebrew (recommended)**
  48. ```bash
  49. brew tap tomfunk/fungible
  50. brew install fungible
  51. fungible --setup # first-time setup wizard
  52. fungible --version # print installed version
  53. fungible
  54. ```
  55. **From source** (Node.js 22+, also works on Linux/WSL)
  56. ```bash
  57. git clone https://github.com/tomfunk/fungible
  58. cd fungible
  59. npm install
  60. npm run dev -- --setup # first-time setup
  61. npm run dev
  62. ```
  63. ### Desktop GUI
  64. Download an installer from the [latest release](https://github.com/tomfunk/fungible/releases/latest) (macOS arm64, Windows x64, Linux x64), or run from source:
  65. ```bash
  66. npm install
  67. npm run gui
  68. ```
  69. The GUI reads/writes the same `~/.fungible/` database as the TUI — switch freely.
  70. For first-launch caveats on the un-notarized installers (Gatekeeper, SmartScreen) and packaging details, see [`docs/gui.md`](docs/gui.md).
  71. ### Storage
  72. Data and config live at `~/.fungible/` (override with `$FUNGIBLE_DATA_DIR`). Plaid access tokens are encrypted at rest using a key file at `~/.fungible/key` — do not delete this file or you will need to re-link your accounts. A free [Plaid](https://plaid.com) developer account (sandbox tier) is enough.
  73. ### Banks that use OAuth (Chase, Amex, Wells Fargo, ...)
  74. These banks send you to their own site to sign in. In a desktop browser Plaid opens that site in a popup, which needs no setup. If Link fails before you reach the bank, the page shows Plaid's error code and Link session ID. In production, a code like `INSTITUTION_REGISTRATION_REQUIRED` means your Plaid team is not yet enabled for that bank: check [US OAuth institutions](https://dashboard.plaid.com/settings/compliance/us-oauth-institutions) in the Plaid Dashboard (Chase also requires the security questionnaire).
  75. If popups are not an option, fungible can take the bank's full-page redirect instead. Plaid accepts `http://localhost` redirect URIs only in sandbox; in production the redirect must be HTTPS, so the local link server needs a certificate for `localhost`, for example from [mkcert](https://github.com/FiloSottile/mkcert):
  76. ```bash
  77. mkcert -install # adds mkcert's local CA to your system trust store (once)
  78. mkcert -cert-file ~/.fungible/localhost.pem -key-file ~/.fungible/localhost-key.pem localhost
  79. ```
  80. Then add to `~/.fungible/.env`, using full paths (`~` is not expanded there):
  81. ```
  82. PLAID_REDIRECT_URI=https://localhost:4747/oauth-return
  83. FUNGIBLE_LINK_TLS_CERT=/Users/you/.fungible/localhost.pem
  84. FUNGIBLE_LINK_TLS_KEY=/Users/you/.fungible/localhost-key.pem
  85. ```
  86. and register the same URI, exactly as written, under Allowed redirect URIs on the Plaid Dashboard's [Developers > API](https://dashboard.plaid.com/developers/api) page. The link server then listens on that port, over HTTPS. Leave `PLAID_REDIRECT_URI` unset to keep the default behaviour.
  87. ## Running
  88. | Command | What starts |
  89. |---------|-------------|
  90. | `fungible` | TUI + MCP server (HTTP, port 3741) + REST API (port 3456) |
  91. | Fungible.app (GUI) | Electron window only — MCP/API not auto-started |
  92. | `fungible mcp` | stdio MCP server only — use this in your Claude Desktop config |
  93. | `fungible api` | REST API server only |
  94. `FUNGIBLE_MCP_PORT` and `FUNGIBLE_API_PORT` (in `~/.fungible/.env`) override the defaults.
  95. ## Screens
  96. | Key | Screen |
  97. |-----|--------|
  98. | `0` | Settings |
  99. | `1` | Dashboard |
  100. | `2` | Transactions |
  101. | `3` | Trends |
  102. | `4` | Net Worth |
  103. | `5` | Tags |
  104. | `6` | Financial Health |
  105. | `7` | Rules |
  106. | `8` | Accounts |
  107. | `9` | Canvas |
  108. Full per-screen keybindings: [`docs/keybindings.md`](docs/keybindings.md).
  109. ## Docs
  110. - [`docs/keybindings.md`](docs/keybindings.md) — per-screen keyboard reference
  111. - [`docs/integrations.md`](docs/integrations.md) — HTTP API and MCP server setup, full tool list
  112. - [`docs/gui.md`](docs/gui.md) — desktop app install, packaging, release flow
  113. - [`docs/testing.md`](docs/testing.md) — how to run tests and what each kind should assert
  114. - [`CONTRIBUTING.md`](CONTRIBUTING.md) — branching policy, tests, PRs

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.