sigil-ledger

A Sigil library for reading, writing, and querying hledger journal files. Build financial automation tools that work with plain-text accounting.

Features

• Journal parsing — read hledger journal files into structured records (transactions, postings, amounts, commodities, tags)
• Journal writing — write and append transactions in valid hledger format
• Multi-currency — full support for cost notation (@ and @@) and balance assertions
• Deduplication — filter out already-imported transactions by reference ID tag
• Report generation — run hledger CLI commands (balance, register, income statement) and parse output
• Round-trip fidelity — parse and re-serialize journals without losing information

Usage

(import (ledger))

;; Parse a journal file
(define txns (read-journal "/path/to/finances.journal"))

;; Create a new transaction
(define txn (journal-transaction
              date: "2026-03-25"
              status: "*"
              description: "Coffee Shop"
              postings: (list
                (journal-posting
                  account: "expenses:food:coffee"
                  amount: (journal-amount quantity: 4.50 commodity: "EUR"))
                (journal-posting
                  account: "assets:wise:eur"))))

;; Append new transactions to journal
(append-transactions "/path/to/finances.journal" (list txn))

Reports via hledger CLI

(import (ledger report))

;; Run a balance report
(hledger-balance "/path/to/finances.journal" "assets" tree: #t)

;; Income statement for a period
(hledger-income-statement "/path/to/finances.journal" period: "2026-03")

sigil deps install
sigil build
sigil test