snippetbashTip

hledger — A robust, friendly plain text accounting app. See also: `hledger-ui`, `hledger-web`. More informatio

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

plainaccountingcommandrobusttexthledgerclifriendly

Problem

How to use the hledger command: A robust, friendly plain text accounting app. See also: hledger-ui, hledger-web. More information: <https://hledger.org/hledger.html>.

Solution

hledger — A robust, friendly plain text accounting app. See also: hledger-ui, hledger-web. More information: <https://hledger.org/hledger.html>.

Record new transactions interactively, saving to the default journal file:

hledger add

Import new transactions from bank.csv, using bank.csv.rules to convert:

hledger import {{path/to/bank.csv}}

Print all transactions, reading from multiple specified journal files:

hledger print {{[-f|--file]}} {{path/to/prices-2024.journal}} {{[-f|--file]}} {{path/to/prices-2023.journal}}

Show all accounts, as a hierarchy, and their types:

hledger accounts {{[-t|--tree]}} --types

Show asset and liability account balances, including zeros, hierarchically:

hledger {{[bs|balancesheet]}} {{[-E|--empty]}} {{[-t|--tree]}} --no-elide

Show monthly incomes/expenses/totals, largest first, summarised to 2 levels:

hledger {{[is|incomestatement]}} {{[-M|--monthly]}} {{[-T|--row-total]}} {{[-A|--average]}} --sort {{[-2|--depth 2]}}

Show the assets:bank:checking account's transactions and running balance:

hledger {{[areg|aregister]}} assets:bank:checking

Show the amount spent on food from the assets:cash account:

hledger print assets:cash | hledger {{[-f|--file]}} - {{[-I|--ignore-assertions]}} aregister expenses:food

Code Snippets

Record new transactions interactively, saving to the default journal file

hledger add

Import new transactions from `bank.csv`, using `bank.csv.rules` to convert

hledger import {{path/to/bank.csv}}

Print all transactions, reading from multiple specified journal files

hledger print {{[-f|--file]}} {{path/to/prices-2024.journal}} {{[-f|--file]}} {{path/to/prices-2023.journal}}

Show all accounts, as a hierarchy, and their types

hledger accounts {{[-t|--tree]}} --types

Show asset and liability account balances, including zeros, hierarchically

hledger {{[bs|balancesheet]}} {{[-E|--empty]}} {{[-t|--tree]}} --no-elide

Context

tldr-pages: common/hledger

Revisions (0)

No revisions yet.