This page is not available in every language. Missing translations are disabled in the language selector.

Quick reference

hledger Plain-Text Accounting Cheatsheet

A quick reference guide for hledger: plain text double-entry accounting reports, balance queries, date smart syntax, multi-column intervals, and accounts.

· Published

hledger is a cross-platform plain-text accounting tool for tracking money, time, and investments using double-entry bookkeeping.

Core Commands & Reports

hledger balance         # Balances summary report (alias: bal)
hledger register        # Running transactions register (alias: reg)
hledger print           # Pretty print parsed journal entries
hledger accounts        # List all account names
hledger stats           # Summary statistics of journal file

Queries & Filtering

Queries apply to all commands (bal, reg, print):

hledger bal assets liab            # Filter by account name pattern
hledger reg 'desc:Amazon'          # Match payee/description
hledger bal cur:USD                # Filter by commodity currency
hledger bal 'tag:project=alpha'    # Filter by transaction tag

Status & Realness

hledger bal status:!               # Pending transactions
hledger bal status:*               # Cleared transactions
hledger bal real:                  # Exclude virtual postings

Period & Date Ranges

hledger bal -p "2026"              # Specific calendar year
hledger bal -p "from 2026-01 to 2026-06"
hledger bal -p "this month"
hledger bal -p "last quarter"
hledger bal --begin 2026-01-01 --end 2026-04-01

Multi-Column Interval Reports

hledger bal expenses --monthly     # Group by month
hledger bal assets --quarterly     # Group by quarter
hledger bal revenue --yearly       # Group by year
hledger bal --cumulative           # Show running cumulative totals
hledger bal --historical           # Ending historical balances

Display Formats

hledger bal --depth 2              # Limit account hierarchy depth to 2
hledger bal --tree                 # Render account hierarchy as a visual tree
hledger bal --flat                 # Render account names in flat list
hledger bal --drop 1               # Strip outermost account prefix

References

Related topics