Skip to main content

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

Supported Formats

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:
  1. Rule Match — checks learned rules from previous entries. Zero AI cost. Instant.
  2. History Match — searches past journal entries with similar descriptions. Zero AI cost.
  3. 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.