# Setup guide — Transaction Reconciliation Agent

## 1. Install and connect (read-only)

Install the agent and connect your sources with read-only access.

```
pipx install reconciler-agent
reconciler-agent connect --bank plaid:readonly --ledger quickbooks:readonly
reconciler-agent doctor
```

## 2. Configure no-adjust guardrails

No forced matches and no auto-adjustments are enforced here.

```
cp .env.example .env
ANTHROPIC_API_KEY=sk-ant-...
LEDGER_WRITE=false          # never posts or edits entries
NO_FORCED_MATCHES=true
NO_BALANCING_PLUG=true
```

## 3. Set matching rules

Define how transactions match and the confidence thresholds.

```
# recon.yml
match_on: [amount, date_window_days: 3, reference, counterparty]
high_confidence: exact_amount_and_reference
review_below: medium
```

## 4. Run a reconciliation

Reconcile a period and review the unmatched and discrepancy report.

```
reconciler-agent run --period 2026-05 --explain
# prints matched set + unmatched + discrepancies + exact net difference
```

## 5. Wire into close

Run each period; flagged items go to a review queue.

```
# period close -> reconcile -> matched cleared; REVIEW_REQUIRED items -> accountant
```
