gitwtfhub

wtf is moxie?

jacobbrooke1/moxie — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · generalComplexity · 2/5LicenseSetup · moderate

TL;DR

A Python AI agent that scans bank transactions for zombie subscriptions and wrong charges, drafts cancellations and disputes, and always asks your permission before sending anything.

Mindmap

mindmap
  root((Moxie))
    What it finds
      Zombie subscriptions
      Duplicate charges
      Missing refunds
    How it acts
      Draft action first
      You approve each step
      Then sends if live mode on
    Data sources
      Bank CSV or PDF
      Plaid or TrueLayer
      Email receipts
      Photo receipts via OCR
    Safety features
      Drafts only by default
      Hash chained audit log
      Never moves money
      Tamper evident log
    Setup
      pip install moxie-agent
      moxie dashboard
      Add API key or Ollama

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Scan three months of bank CSVs to find forgotten subscriptions you are still being charged for, review each one, and approve a cancellation email.

REASON 2

Dispute a duplicate charge by letting Moxie draft the dispute email with the scanned receipt attached, then approve and send it from your own inbox.

REASON 3

Upload bank statements and run moxie scan to get a plain-language list of potential money leaks before deciding which ones to act on.

What's in the stack?

PythonCLITesseract OCROllama

How it stacks up

jacobbrooke1/moxiea-bissell/unleash-liteabhiinnovates/whatsapp-hr-assistant
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity2/54/53/5
Audiencegeneralresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Pending independent security review, keep MOXIE_LIVE=false until you have read the code. Requires an AI API key or a local Ollama model.

MIT license, meaning you can use, modify, and distribute it freely for any purpose including commercial use.

Wtf does this do

Moxie is an open-source Python program that scans your bank transactions, finds money you are probably losing, and helps you get it back. It looks for zombie subscriptions you forgot about, duplicate charges, and refunds that were promised but never arrived. It is designed to sit between two extremes: tools that only track your spending and services that act automatically without asking. When Moxie finds a problem, it writes a draft action, such as a cancellation email or a formal dispute, and shows it to you before anything is sent. You can edit the draft, approve it, or skip it. Nothing sends unless you explicitly say yes and have enabled live mode. By default the tool produces only drafts, so exploring it with real bank data carries no risk of unintended actions. The program works with bank statement CSV or PDF files you export yourself, or a read-only bank connection through aggregators like Plaid or TrueLayer. There is also a receipt vault where you scan a photo of a receipt or connect your email inbox to pull receipts in automatically. When you dispute a charge, the relevant receipt is attached as evidence. All actions are recorded in a hash-chained audit log that you can verify later to confirm it has not been modified. A community skill library holds reusable instructions for cancelling or disputing with specific companies, each carrying a tracked success rate. The program runs on your machine with your own AI API key (Claude or a locally running Ollama model). It includes a web dashboard and a command-line interface. The project is labeled as early scaffold and is pending an independent security review, so it should be used with caution with live financial data. It does not move money: payments and transfers are explicitly out of scope. The project is licensed under MIT.

Yoink these prompts

Prompt 1
I installed Moxie and want to find zombie subscriptions in my bank CSV. Walk me through running moxie scan --csv statement.csv and reviewing the results safely in drafts-only mode.
Prompt 2
Help me set up Moxie's receipt vault using email IMAP scanning so receipts from my inbox are matched automatically to bank transactions.
Prompt 3
Explain how Moxie's hash-chained audit log works and show me how to run moxie verify to confirm it has not been tampered with.
Prompt 4
I want to write a new Moxie skill for disputing charges with a specific airline. Describe the skill file format and what a success rate field tracks.
Prompt 5
Walk me through enabling MOXIE_LIVE=true and configuring my Gmail app password so an approved cancellation actually sends from my own email address.

Frequently asked questions

wtf is moxie?

A Python AI agent that scans bank transactions for zombie subscriptions and wrong charges, drafts cancellations and disputes, and always asks your permission before sending anything.

What language is moxie written in?

Mainly Python. The stack also includes Python, CLI, Tesseract OCR.

What license does moxie use?

MIT license, meaning you can use, modify, and distribute it freely for any purpose including commercial use.

How hard is moxie to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is moxie for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.