explaingit

jacobbrooke1/moxie

Analysis updated 2026-05-18

1PythonAudience · generalComplexity · 2/5LicenseSetup · moderate

TLDR

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
Click or tap to explore — scroll the page freely

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

What do people build with it?

USE CASE 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.

USE CASE 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.

USE CASE 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 is it built with?

PythonCLITesseract OCROllama

How does it compare?

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 get it running?

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.

In plain English

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.

Copy-paste 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

What 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.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub jacobbrooke1 on gitmyhub

Verify against the repo before relying on details.