# hledger ## Robust, intuitive plain text accounting [![license](https://img.shields.io/badge/license-GPLv3+-brightgreen.svg)](https://www.gnu.org/licenses/gpl.html) [![on hackage](https://img.shields.io/hackage/v/hledger.svg?label=hackage&colorB=green)](https://hackage.haskell.org/package/hledger) [![](https://repology.org/badge/version-for-repo/stackage_nighly/hledger.svg)](https://repology.org/metapackage/hledger) [![](https://repology.org/badge/version-for-repo/stackage_lts/hledger.svg)](https://repology.org/metapackage/hledger) \ [![Repo Health](https://api.gitscope.dev/api/badges/simonmichael/hledger/health.svg "Overall repository health score from 0-100%. Calculated from activity, maintenance, community engagement, and issue management.")](https://gitscope.dev/docs/badges) [![Maintained](https://api.gitscope.dev/api/badges/simonmichael/hledger/maintained.svg "Maintenance status: very active, active, maintained, or stale based on recent commit and issue activity.")](https://gitscope.dev/docs/badges) [![Response Time](https://api.gitscope.dev/api/badges/simonmichael/hledger/response-time.svg "Average time maintainers take to respond to new issues.")](https://gitscope.dev/docs/badges) [![Contributors](https://api.gitscope.dev/api/badges/simonmichael/hledger/contributors.svg "Total number of unique contributors to the repository. The true number as of 2025 is 185+.")](https://hledger.org/CREDITS.html) \ [![Documentation](https://api.gitscope.dev/api/badges/simonmichael/hledger/docs.svg "Documentation quality indicator based on README completeness, wiki presence, and linked documentation.")](https://hledger.org/doc.html) [![Open issues, all kinds](https://img.shields.io/github/issues/simonmichael/hledger.svg "Open issues, all kinds.")](https://github.com/simonmichael/hledger/issues?q=is:issue+state:open) [![Open bugs](https://api.gitscope.dev/api/badges/simonmichael/hledger/label/A-BUG.svg "Open bugs")](https://github.com/simonmichael/hledger/issues?q=is:issue+label:A-BUG+state:open) [![Open wishes](https://api.gitscope.dev/api/badges/simonmichael/hledger/label/A-WISH.svg "Open wishes")](https://github.com/simonmichael/hledger/issues?q=is:issue+label:A-WISH+state:open) [![Issues Resolved](https://api.gitscope.dev/api/badges/simonmichael/hledger/resolved.svg "Percentage of issues resolved/closed during last N days. Higher is better. Click to see closed bugs.")](https://github.com/simonmichael/hledger/issues?q=is:issue+state:closed) Welcome! This is a brief intro to hledger. For a more detailed version, see the home page: **** hledger is lightweight, cross platform, multi-currency, double-entry accounting software. It lets you track money, investments, cryptocurrencies, invoices, time, inventory and more, in a safe, future-proof plain text data format with full version control and privacy. hledger aims to help both computer experts and regular folks gain clarity in their finances and time management. Though the UIs are basic, hledger can model any accounting situation and provide precise, clear reports. It is reliable, quick, and backed by the highly supportive [Plain Text Accounting](https://plaintextaccounting.org) ecosystem. Using it is an excellent way to learn double entry accounting. Compared to [other PTA apps](https://plaintextaccounting.org/#software), hledger is actively maintained, with regular releases, and a strong focus on being easy to use and practical for everyday accounting. More features: - Installs easily on unix, mac or windows - Complete, built-in documentation in multiple formats, beginner videos, tutorials etc. - Multiple UIs: command-line, terminal, web, mobile, editors/IDEs - Good at importing and exporting CSV; also outputs text/HTML/JSON/SQL - A robust, general, well-specified multi-currency accounting engine - Fast, analysing 25k transactions per second on a macbook air m1 - Accurate to 255 decimal places - Supports your preferred account names, currencies, number formats - Inspired by and partly compatible with Ledger CLI; interconvertible with Beancount - Scriptable by CLI, HTTP or API, with plenty of examples - Clean Haskell codebase, continually improved since 2007, with $100 regression bounties - Free software licensed under GNU General Public License v3.0 or later. ## Examples I use hledger to: - track income and spending, sometimes with budgets - see time reports by day/week/month/project - track reimbursables, invoices and payments - predict cashflow and account balances - get accurate numbers for tax filing - research past events Here's an example of the journal file format: ```journal 2022-01-01 opening balances as of this date assets:bank:checking $1000 assets:bank:savings $2000 assets:cash $100 liabilities:creditcard $-50 equity:opening/closing balances 2022-01-15 market expenses:food $50 assets:cash $-50 2022-02-01 GOODWORKS CORP assets:bank:checking $1000 income:salary $-1000 ``` and some simple reports: ```cli $ hledger bs Balance Sheet 2022-02-15 || 2022-02-15 ========================++============ Assets || ------------------------++------------ assets:bank:checking || $2000 assets:bank:savings || $2000 assets:cash || $50 ------------------------++------------ || $4050 ========================++============ Liabilities || ------------------------++------------ liabilities:creditcard || $50 ------------------------++------------ || $50 ========================++============ Net: || $4000 ``` ```cli $ hledger is --monthly Income Statement 2022-01-01..2022-02-28 || Jan Feb ===============++============= Revenues || ---------------++------------- income:salary || 0 $1000 ---------------++------------- || 0 $1000 ===============++============= Expenses || ---------------++------------- expenses:food || $50 0 ---------------++------------- || $50 0 ===============++============= Net: || $-50 $1000 ``` More examples and screenshots: ## hledger 1.x and 2.x In 2026, the `master` branch was renamed to `hledger1`, and work began on hledger 2.x, now in the `main` branch. Some goals for 2.x: - continue and improve 1.x's reliability - provide excellent lot tracking and capital gains calculation - explore ethical use of AI as a dev tool - more cleanup and simplification of code, docs, process, finance - more speed - more interoperability - more use of jj for version management - easier contribution and for 1.x: - continued stability, installability - bugfix releases to fix newly discovered regressions, if any - preserve the non-AI-assisted codebase, and try to keep it that way Related: - [Thoughts on hledger 2 #2547](https://github.com/simonmichael/hledger/issues/2547) - - ## Funding hledger is brought to you by [Simon Michael](http://joyful.com), [140+ contributors](doc/CREDITS.md), and the generous financial sponsors below. After enjoying some personal or organisational success with hledger, you might want to become one of them, to help support this work. It's easy! Please see for details. ### Organisational sponsors ### Individual sponsors