lim add
The add command is lim’s signature feature. Describe a transaction in plain language and lim creates the correct journal entry, including tax decomposition.
Basic Usage
Examples
File Attachments
Attach receipts, invoices, or screenshots. lim extracts vendor, amount, date, and description using vision AI.
Multiple Files
Images are automatically resized before sending to the vision API. Files larger than 20MB are
rejected. For best results, ensure receipts are well-lit and text is readable.
The 3-Step Judgment Process
When you run lim add, the engine processes your input through three steps:
- Rule Match — checks learned rules from previous entries. Zero AI cost. Instant.
- History Match — searches past journal entries with similar descriptions. Zero AI cost.
- AI Inference — calls an LLM to classify the transaction. Only used as a last resort.
If all three steps produce low confidence, the entry is created in draft status for human review.
Flags
Interactive Confirmation
By default, lim add shows the proposed journal entry and asks for confirmation:
Options:
- Y (default) — confirm and post. The entry is learned for next time.
- n — cancel.
- edit — open an interactive editor to modify accounts or amounts.
Use --yes or -y to skip the confirmation prompt in scripts and automation.
JSON Output
When autoPost is true, the entry is posted without confirmation. This happens when a rule has been confirmed enough times (confidence >= 0.95). Use --draft to override this behavior.