Command-line-driven accounting toolchain.

TypeScript 96.9%
Shell 3.1%

Find a file

Karsten Schmidt 16a68383d8 refactor: update CLI command specs, reformat		2026年05月01日 01:16:06 +02:00
.yarn/releases	build: update deps, yarn, gitignore	2026年05月01日 01:15:28 +02:00
packages/ledger-cli	refactor: update CLI command specs, reformat	2026年05月01日 01:16:06 +02:00
tools	build: update deps, yarn, gitignore	2026年05月01日 01:15:28 +02:00
.gitignore	build: update deps, yarn, gitignore	2026年05月01日 01:15:28 +02:00
.prettierrc	build: update deps, yarn, gitignore	2026年05月01日 01:15:28 +02:00
.yarnrc.yml	build: update deps, yarn, gitignore	2026年05月01日 01:15:28 +02:00
package.json	build: update deps, yarn, gitignore	2026年05月01日 01:15:28 +02:00
README.md	docs: add readme, update pkg meta	2025年08月12日 11:31:15 +02:00
tsconfig.json	feat: initial import	2025年08月06日 10:59:28 +02:00
typedoc.json	feat: initial import	2025年08月06日 10:59:28 +02:00
yarn.lock	build: update deps, yarn, gitignore	2026年05月01日 01:15:28 +02:00

README.md

@thi.ng/ledger-cli

Command-line-driven accounting toolchain.

npx @thi.ng/ledger-cli --help
 █ █ █ │
██ █ │
 █ █ █ █ █ █ █ █ │ @thi.ng/ledger-cli v1.0.0
 █ █ █ █ █ █ █ █ █ │ Multi-command CLI for thi.ng/ledger toolchain
 █ │
 █ █ │
Usage: ledger-cli <cmd> [opts] input [...]
 ledger-cli <cmd> --help
Available commands:
classify : Classify transactions using provided rules & filters
import : Import transactions from CSV using provided import rules & transforms
report : Produce balance reports (optionally filtered) in different formats

import

Import transactions from CSV using provided import rules & transforms:

ledger-cli import --help
Flags:
--dry-run Dry run (no changes applied)
-q, --quiet Disable logging
-v, --verbose Display extra information
Main:
--db STR Ledger DB path (default: $THING_LEDGER_FILE)
-r STR, --rules STR [required] Import rules (CSV column transforms)

classify

Classify transactions using provided rules & filters:

ledger-cli classify --help
Flags:
--dry-run Dry run (no changes applied)
-q, --quiet Disable logging
-v, --verbose Display extra information
Main:
--db STR Ledger DB path (default: $THING_LEDGER_FILE)
-j STR, --journal STR Ledger journal path (default: $THING_JOURNAL_FILE)
-r STR, --rules STR [required, multiple] Classifier rules

report

Produce balance reports (optionally filtered) in different formats:

ledger-cli report --help
Flags:
-a, --aggregate Compute aggregates of nested balances
-q, --quiet Disable logging
-v, --verbose Display extra information
Main:
-d STR, --delim STR Delimiter char for nested balance IDs (default: ":")
-f ID, --fmt ID Output format: "csv", "json", "md" (default: "md")
-j STR, --journal STR Ledger journal path (default: $THING_JOURNAL_FILE)
-o STR, --out-file STR Output file (uses stdout if omitted)
Filters:
--from DATE Start date (yyyy-MM-dd format)
-i NAME, --include NAME [multiple] Only include given balance ID
--to DATE End date (yyyy-MM-dd format)

README.md

@thi.ng/ledger-cli

import

classify

report

License