v0.1.84

davidfowl/tallyv0.1.84Dec 28, 2025by github-actions[bot]

AI Summary

Added the `tally explain` command to expose AI-friendly classification reasoning and new JSON/Markdown export formats.

Key Highlights

  • New `tally explain` command exposes the full decision-making process for classifications.
  • JSON and Markdown output formats allow programmatic consumption of analysis data.
  • Improved error messages with fuzzy matching suggestions.

New Features

  • AI-friendly `tally explain` command
  • JSON output format with decision traces
  • Markdown output format
  • Improved error messages

Full Release Notes

## What's Changed

### New: `tally explain` Command - AI-Friendly Classification Reasoning

Ever wonder why a merchant ended up in "Variable" instead of "Monthly"? Now your AI agent can find out.

The new `tally explain` command exposes the full decision-making process, making it easy for LLMs to understand classifications and suggest better rules:

```bash
tally explain                    # Overview of all classifications
tally explain Netflix            # Explain specific merchant
tally explain Netflix -vv        # Full details + which rule matched
tally explain --category Food    # Explain all Food merchants
```

Example output with `-vv`:
```
Netflix → Monthly
  Monthly: Subscriptions appears 6/6 months (50% threshold = 3)

  Decision trace:
    ✗ NOT excluded: Subscriptions not in [Transfers, Cash, Income]
    ✓ IS monthly: Subscriptions with 6/6 months (>= 3 bill threshold)

  Calculation: avg (CV=0.00, payments are consistent)
  Rule: NETFLIX.* (user)
```

The `Rule:` line shows exactly which pattern matched and whether it came from your `merchant_categories.csv` (user) or the built-in rules (baseline) — so agents can confidently suggest rule additions or modifications.

### New: JSON/Markdown Output Formats

Export analysis with full reasoning data for programmatic consumption:

```bash
tally run --format json -v       # JSON with decision traces
tally run --format markdown      # Markdown report
tally run --only monthly,travel  # Filter to specific classifications
```

Perfect for piping into your AI agent's context or building custom dashboards.

### Improved Error Messages

CLI errors now guide you to the right answer:
- Invalid `--only` values warn and show valid options
- Invalid `--category` shows available categories  
- Typos in merchant names suggest similar matches (fuzzy matching)

---

### Install

**Linux / macOS:**
```bash
curl -fsSL https://tallyai.money/install.sh | bash
```

**Windows PowerShell:**
```powershell
irm https://tallyai.money/install.ps1 | iex
```

Or download the zip for your platform from the assets below.

See https://tallyai.money for more info.