Convert CSV banking statements to hledger journals
README.md

csv2journal #

Converts bank CSV exports into hledger journals.

Warning

Project status: This is early experimental software. I'm just starting to use it and it will change often. I do not yet advise to use it to anyone else.

Classification rules are named and order-independent. Every data row must match exactly one rule; zero matches and multiple matches are errors rather than things resolved by declaration order. Rules are also checked against history: within the input root, bank/2026.csv pairs with the colocated bank/2026.csv.journal, and current rules must still reproduce every journal already approved. A rule change that would alter past output is caught before anything is written.

The sole CSV without a journal beside it is the one being imported.

Status #

Milestone one is specified and designed. Not yet implemented.

Documentation #

Document Contents
docs/VISION.md Product principles
docs/REQUIREMENTS.md Milestone-one behaviour
docs/DESIGN_M1.md Technical design
docs/PROCESS.md How this project is developed
docs/PLAN_M1.md Build order and tasks
docs/yaml/ Example configuration

Planned interface #

csv2journal check       MANIFEST
csv2journal convert     MANIFEST
csv2journal interactive MANIFEST [--listen HOST:PORT]

check validates without writing. convert validates, then atomically creates the one missing journal. interactive serves a local rule editor on 127.0.0.1:8080, and logs to stdout; CSV2JOURNAL_LOG=debug adds a line per connection, request and evaluation step, with timings.

Building #

Zig 0.17.0, packaged as a Nix flake. hledger 1.52.3 is a test-only dependency; it is never invoked at runtime.