lim journals
Manage journal entries directly from the CLI. List, inspect, create structured entries, reverse, and perform bulk operations.
journals list
List journal entries with optional filters.
ID Date Status Memo Debit Credit
────────────────────────────────────────────────────────────────────────────────────
01926f3a 2026-03-16 posted AWS monthly bill 11,000 11,000
01926f3b 2026-03-15 posted Received from Acme Corp 550,000 550,000
01926f3c 2026-03-14 draft Office supplies 3,300 3,300
────────────────────────────────────────────────────────────────────────────────────
3 entries
Filters
| Flag | Description | Example |
|---|
--from | Start date (inclusive, YYYY-MM-DD) | --from 2026-01-01 |
--to | End date (inclusive, YYYY-MM-DD) | --to 2026-03-31 |
--status | Filter by status: draft, posted, reversed | --status draft |
--limit | Max entries to return (default: 50) | --limit 100 |
--offset | Skip first N entries | --offset 50 |
--source | Filter by source: manual, bank_sync, invoice, expense | --source bank_sync |
--account | Filter by account code or ID | --account 5101 |
--label | Filter by label ID | --label <label-id> |
# All draft entries from March
lim journals list --from 2026-03-01 --to 2026-03-31 --status draft
# Last 10 bank-synced entries
lim journals list --source bank_sync --limit 10
journals show
Show full detail for a single journal entry.
lim journals show <journal-id>
Journal Entry: 01926f3a-...
Date: 2026-03-16
Status: posted
Source: manual
Memo: AWS monthly bill
Lines:
Debit Communication (5101) 10,000
Debit Input VAT (1501) 1,000
Credit Accounts payable (2101) 11,000
Labels: cloud-infra
Documents: receipt-aws-march.pdf
Created: 2026-03-16T09:30:00Z by user (tsumi@uselim.com)
journals create
Create a journal entry with explicit debit/credit lines. For natural language input, use lim add instead.
lim journals create \
--date 2026-03-16 \
--memo "Office rent March" \
--debit 7101:100000 \
--credit 1101:100000
✅ Created journal entry 01926f3d-...
Rent expense 100,000 / Cash 100,000
Flags
| Flag | Description |
|---|
--date | Effective date (YYYY-MM-DD), defaults to today |
--memo | Description / memo |
--debit | Debit line as <account-code>:<amount> (repeatable) |
--credit | Credit line as <account-code>:<amount> (repeatable) |
--status | Initial status: draft or posted (default: posted) |
--label | Attach a label ID (repeatable) |
Total debits must equal total credits. The command will fail with an error if they don’t balance.
journals reverse
Create reversing entries for journal entries matching the specified filters.
lim journals reverse --from 2026-01 --to 2026-01 --dryRun
Dry run — the following entries would be reversed:
01926f3a-... (2026-01-05, AWS monthly bill)
01926f3b-... (2026-01-15, Office rent)
2 entries matched. No changes applied.
# Apply the reversal
lim journals reverse --from 2026-01 --to 2026-01
✅ Created 2 reversing entries
01926f3e-... reverses 01926f3a-... (AWS monthly bill)
01926f3f-... reverses 01926f3b-... (Office rent)
| Flag | Description |
|---|
--from | Start period (required, YYYY-MM or YYYY-MM-DD) |
--to | End period (required, YYYY-MM or YYYY-MM-DD) |
--dryRun | Preview what would be reversed without applying |
--date | Date for the reversing entries (default: today) |
--memo | Override memo (default: “Reversal of “) |
journals bulk-update-tax-code
Update the tax code for multiple journal entries at once. Useful after a tax code change or correction.
lim journals bulk-update-tax-code \
--from 2026-01-01 \
--to 2026-03-31 \
--old-tax-code standard_10 \
--new-tax-code reduced_8
⚠️ This will update 47 journal lines.
? Proceed? (y/N) y
✅ Updated 47 lines across 32 journal entries.
| Flag | Description |
|---|
--from | Start date (required) |
--to | End date (required) |
--old-tax-code | Current tax code to replace (required) |
--new-tax-code | New tax code (required) |
--dry-run | Show what would change without applying |
journals bulk-delete
Delete multiple journal entries. Requires explicit confirmation.
lim journals bulk-delete --from 2026-03-01 --to 2026-03-31 --status draft
⚠️ This will delete 12 draft journal entries from March 2026.
? Type "DELETE" to confirm: DELETE
✅ Deleted 12 journal entries.
Bulk delete is irreversible. Only draft entries can be bulk-deleted. Posted entries must be reversed instead.
| Flag | Description |
|---|
--from | Start date (required) |
--to | End date (required) |
--status | Status filter (default: draft) |
--source | Source filter |
--dry-run | Show what would be deleted without applying |
