List, create, reverse, and manage journal entries.
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 Marchlim journals list --from 2026-03-01 --to 2026-03-31 --status draft# Last 10 bank-synced entrieslim 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.
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 numberlim journals reverse --id 5lim journals reverse --id 1 --id 2 --id 3# Reverse by filterlim journals reverse --from 2026-03-01 --to 2026-03-31lim 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 entrieslim journals delete --id 10 --id 11# Preview what would be deletedlim journals delete --id 10 --id 11 --dry-run# Skip confirmationlim 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.