minimus7andClaude Opus 5.5 1e246336a2 broke ai: short answers with a breakdown, actions and follow-ups (#7)
Answers lead with one sentence and the key number. A split of money is a
breakdown block drawn as rows with the category icons, things to do are
actions that open the broke page that does them, and follow-up questions
are buttons under the answer. Output only: nothing new goes to the model.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-12 17:39:40 -06:00

broke

See where your money goes, get a plan for it, and ask your own AI about it. Your bank data stays in your own database.

Next.js 15, Supabase, Plaid. Free to run. AI uses the app you already pay for, with no API keys.

Run it on your computer

The easiest way. Needs Node.js and git. On Mac or Linux:

curl -fsSL https://raw.githubusercontent.com/nextwork-projects/broke/main/install.sh | sh

This puts broke in ~/broke and opens a setup page. Paste in your keys there, one step at a time:

  1. Supabase (free): your database and sign-in.
  2. Plaid (free for test banks): your bank connection.
  3. AI (optional): broke finds Claude Code, Codex, Gemini CLI, opencode or a local model on your computer. Or connect OpenRouter in one click.

To start it again: open a new Terminal window and type broke.

On Windows: git clone https://github.com/nextwork-projects/broke, then npm run app in that folder.

Put it online

Use it from your phone, on a site only you own.

Deploy with Vercel

  1. Create a free Supabase project and get Plaid keys.
  2. Press the button and paste them in. SUPABASE_DB_URL is under Supabase, Connect, Session pooler. broke creates its tables as it builds.
  3. Open your new site. It shows one step to do in Supabase before your first sign-in.
  4. Sign in once, then turn off "Allow new users to sign up" under Authentication, Sign In / Providers, so nobody else can use your copy.

AI on an online copy: connect OpenRouter in one click. Or, to use your Claude or opencode plan, press Connect my computer on Connect your AI and run the command it gives you. Your AI login stays on your computer. AI answers while that command is running.

Improve it

broke is yours to change. Open the folder and tell your AI app what you want:

cd ~/broke && claude

CLAUDE.md tells it the privacy rules. Run npm run dev to see changes as they happen. On an online copy, git push publishes them.

Get the latest broke: it updates itself each time you start it (broke, or the install command), as long as you haven't changed its code. With your own changes, run npm run update. To turn auto-update off, start it with BROKE_NO_AUTO_UPDATE=1. On an online copy there's nothing to install: in your GitHub repo open Actions, Update broke, Run workflow, and Vercel rebuilds your site. Your changes stay either way.

If you make something others would want, send a pull request.

Banks

Banks in other countries (all optional, keys on the Setup page): Plaid (US, Canada), Akahu (New Zealand), Enable Banking (UK, Europe), Basiq (Australia), Belvo (Brazil). Each shows only for that country. Enable Banking, Basiq and Belvo are built from their public docs and tested against stand-ins, so test against the vendor's sandbox before relying on them. Anywhere else, people import a CSV, OFX, QIF or PDF statement.

In test mode, press Use a test bank, or pick any bank in Plaid Link with username user_good and password pass_good.

How AI stays private

Every AI path goes through one gate. A cloud model gets a summary: rounded amounts, names replaced by tokens. Full detail goes only to a local model. You can turn AI off in Settings. Each answer runs with no way to change your data.

Scripts

  • npm run migrate: apply database changes now. They also apply on start.
  • node --env-file=.env --env-file-if-exists=.env.local scripts/e2e-sandbox.mjs: throwaway user, test bank, every page, user deleted.
  • node src/lib/format.test.ts and node src/lib/llm/config.test.ts: unit checks.

Licence

MIT.

S
Description
No description provided
Readme MIT
3.7 MiB
0 Stars 1 Watchers 0 Forks
Languages
TypeScript 87.9%
HTML 7.1%
JavaScript 3%
PLpgSQL 1.5%
CSS 0.4%