lim journals

Manage journal entries directly from the CLI. List, inspect, create structured entries, reverse, and delete. All destructive operations (reverse, delete, update-tax-code) show a preview and require confirmation before executing. Use --dry-run for preview-only, --yes to skip confirmation (for scripting / AI agents).

journals list

List journal entries with optional filters.

lim journals list

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`
`--search`	Search memo text	`--search タクシー`
`--limit`	Max entries to return (default: 50)	`--limit 100`
`--page`	Page number	`--page 2`
`--source`	Filter by source: `manual`, `bank_sync`, `invoice`, `expense`	`--source bank_sync`
`--account`	Filter by account code or ID	`--account 5101`
`--sort`	Sort by: `sequence`, `effectiveDate`, `createdAt`	`--sort effectiveDate`

# 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 <seq-or-id>

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

Flag	Description
`--date`	Effective date (YYYY-MM-DD)
`--memo`	Description / memo
`--debit`	Debit line as `<account-code>:<amount>` (repeatable)
`--credit`	Credit line as `<account-code>:<amount>` (repeatable)

Total debits must equal total credits. The command will fail with an error if they don’t balance.

journals edit

Edit a draft journal entry. Only draft entries can be edited — posted entries must be reversed and re-created.

# Update date and memo
lim journals edit 42 --date 2026-03-20 --memo "Corrected memo"

# Replace journal lines (both --debit and --credit required)
lim journals edit 42 \
  --debit 7101:120000 \
  --credit 1101:120000

# Update everything at once
lim journals edit 42 \
  --date 2026-03-20 \
  --memo "Corrected entry" \
  --debit 7101:120000 \
  --credit 1101:120000

Flag	Description
`--date`	New effective date (YYYY-MM-DD)
`--memo`	New description / memo
`--debit`	New debit line as `<account-code>:<amount>` (repeatable)
`--credit`	New credit line as `<account-code>:<amount>` (repeatable)

When updating lines, both --debit and --credit must be provided. Lines are fully replaced, not merged. Only draft entries can be edited. For posted entries, use lim journals reverse then lim journals create.

journals reverse

Create reversing entries for specific journal entries. Shows a preview and asks for confirmation before executing.

# Reverse specific entries by sequence number
lim journals reverse --id 5
lim journals reverse --id 1 --id 2 --id 3

# Reverse by filter
lim journals reverse --from 2026-03-01 --to 2026-03-31
lim journals reverse --search タクシー

# Preview only (no execution)
lim journals reverse --id 5 --dry-run

# Skip confirmation (for scripting / AI agents)
lim journals reverse --id 5 --yes

You must specify at least one --id or filter flag. Running lim journals reverse with no arguments will show an error — it will NOT reverse all entries.

Flag	Description
`--id`	Entry sequence or ID to reverse (repeatable)
`--from`	Start date filter (YYYY-MM-DD)
`--to`	End date filter (YYYY-MM-DD)
`--status`	Filter by status
`--search`	Search memo text
`--source`	Filter by sourceType
`--account`	Filter by account ID
`--dry-run`	Preview what would be reversed without applying
`--yes`	Skip confirmation prompt

journals delete

Delete draft journal entries. Only draft entries can be deleted — posted entries must be reversed instead.

# Delete specific entries
lim journals delete --id 10 --id 11

# Preview what would be deleted
lim journals delete --id 10 --id 11 --dry-run

# Skip confirmation
lim journals delete --id 10 --yes

Deletion is irreversible. Only draft entries can be deleted. For posted entries, use lim journals reverse instead.

Flag	Description
`--id`	Entry sequence or ID to delete (repeatable, required)
`--dry-run`	Show what would be deleted without applying
`--yes`	Skip confirmation prompt

journals update-tax-code

Update the tax code for journal lines matching a filter. Useful after a tax code change or correction.

lim journals update-tax-code \
  --from 2026-01-01 \
  --to 2026-03-31 \
  --oldTaxCodeId <uuid> \
  --newTaxCodeId <uuid>

Flag	Description
`--from`	Start date filter
`--to`	End date filter
`--account`	Filter by account ID
`--search`	Search memo text
`--oldTaxCodeId`	Current tax code to replace (required)
`--newTaxCodeId`	New tax code (required)
`--dry-run`	Show what would change without applying
`--yes`	Skip confirmation prompt

CLI Basics

Money In & Money Out

Operations & Compliance

lim journals

lim journals

journals list

Filters

journals show

journals create

journals edit

journals reverse

journals delete

journals update-tax-code

​lim journals

​journals list

​Filters

​journals show

​journals create

​journals edit

​journals reverse

​journals delete

​journals update-tax-code

lim journals

journals list

Filters

journals show

journals create

journals edit

journals reverse

journals delete

journals update-tax-code