Ledger CLI: Command-Line Double-Entry Accounting with Plain Text Journals
Ledger CLI is where the idea of plain text accounting really began. It’s been around for years, and while many tools have tried to copy or simplify the concept, Ledger remains the reference point. At its heart it’s just a command-line program that reads text files and turns them into financial reports. No databases, no locked formats — just plain text that anyone can keep for decades without worrying about compatibility.
Everyday use
Using Ledger feels very different from opening a mobile budgeting app. There’s no dashboard, no colorful charts on first launch. Instead, it starts with a text file: write a date, an amount, and the accounts involved. That’s all. From there, the magic is in the commands — ledger balance, ledger register, or more complex queries — which instantly return summaries and breakdowns. Some people compare it to “programming with money,” because it rewards those who like structure and scripting.
Specs & notes
| Item | Details |
| License | Open source (BSD) |
| Platforms | Linux, macOS, Windows |
| Data storage | Plain text journals |
| Import / Export | CSV, QIF, OFX (via scripts or community tools) |
| Accounts | Unlimited, created manually |
| Budgets | Possible through rules and queries |
| Recurring | Managed with periodic entries |
| Reports | Balance sheets, income/expense, cashflow, fully scriptable |
| Multi-currency | Supported |
| Privacy | Works fully offline; complete control over files |
Getting started
Installation is usually done through a package manager — apt, brew, choco, depending on the system. Once it’s installed, the process begins with creating a file like ledger.journal and typing the first transactions. After that, a single command can turn lines of text into a financial overview. Because it’s command-line based, Ledger also fits naturally into scripts and automation, which explains why it has a loyal following among technical users.
Who uses it
It’s often chosen by developers, sysadmins, and people who are comfortable with text files. Some like it because it keeps their financial history future-proof, others because it can be adapted endlessly with scripts. It isn’t a mass-market budgeting app — it’s more of a toolkit for those who want to bend the rules and build reports their own way.
Why it sticks
Ledger CLI has lasted this long because it doesn’t try to hide anything. The format is open, the reports are flexible, and the workflow doesn’t depend on any company staying in business. For users who care about independence and control, that’s a rare promise — and the reason Ledger is still talked about after two decades.
