Accounting CLI

An open-source command-line bookkeeping tool.

Features

• Accounting-standards-compliant workflows
• Double-entry bookkeeping with automatic balance validation
• Local SQLite storage for auditability and backups
• Voucher query, balance summary, and ledger reporting
• CSV export for interoperability
• Protection on dangerous operations

Quick Start

npm install -g accounting-cli
acc --help

Use with npx (no global install required):

npx accounting-cli --help

Run from source:

npm install
npm run build
node dist/main.js --help

Example

# Initialize book
acc --book ./book.db init --name "My Business Book"

# Create accounts
acc --book ./book.db account add --code 1001 --name "Cash on Hand" --type asset
acc --book ./book.db account add --code 6001 --name "Operating Revenue" --type revenue

# Post voucher
acc --book ./book.db voucher add \
  --date 2026-03-17 \
  --desc "Sales receipt" \
  --line D:1001:1000.00 \
  --line C:6001:1000.00

# Query and reports
acc --book ./book.db voucher list --from 2026-03-01 --to 2026-03-31
acc --book ./book.db report balance --as-of 2026-03-31

# Reverse voucher (dangerous operation)
acc --book ./book.db voucher reverse --id 1 --date 2026-03-18 --desc "Reversal entry" --yes

# Export
acc --book ./book.db export vouchers --from 2026-03-01 --to 2026-03-31 --output vouchers.csv

Tech Stack

• TypeScript
• Node.js
• SQLite

Contributing

Issue and PR submissions are welcome.

License

MIT