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:
- Supabase (free): your database and sign-in.
- Plaid (free for test banks): your bank connection.
- 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.
- Create a free Supabase project and get Plaid keys.
- Press the button and paste them in.
SUPABASE_DB_URLis under Supabase, Connect, Session pooler. broke creates its tables as it builds. - Open your new site. It shows one step to do in Supabase before your first sign-in.
- 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: run npm run update. 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.tsandnode src/lib/llm/config.test.ts: unit checks.
Licence
MIT.