---
name: finance-cli
description: Use this skill to operate the mere.fi CLI for profiles, scoped token auth, accounts, transactions, reports, tax config, bank accounts, reconciliations, imports, exports, roles, and health checks.
---

# Finance CLI

Use this skill for requests that operate the `merefi` CLI in `/Users/nerd/mere/finance`.

## Quick Start

1. Work from the repo root:
   - `cd /Users/nerd/mere/finance`
2. Build the CLI:
   - `pnpm -C packages/cli build`
3. Inspect commands:
   - `node packages/cli/dist/cli/bin/merefi.js --help`
4. Authenticate with a scoped token:
   - `node packages/cli/dist/cli/bin/merefi.js auth login --token <TOKEN> --base-url <URL>`
   - `node packages/cli/dist/cli/bin/merefi.js auth whoami`
5. Prefer `--json` for automation.

Config file:

- `~/.config/merefi/config.json`

## Command Families

- `auth login|logout|whoami`
- `tokens create|list|revoke`
- `accounts list|create|update|delete`
- `transactions list|create|update|delete`
- `reports ledger|trial-balance|balance-sheet|income-statement|gst-hst|gst-return|tax-provision`
- `tax config get|set`
- `bank accounts list|create|update|delete`
- `bank reconciliations list|get|create`
- `plaintext validate|import|export`
- `roles list|set`
- `admin migrate run`
- `health canary`
- `completion [bash|zsh|fish]`

## References

- `/Users/nerd/mere/finance/docs/cli/README.md`
- `/Users/nerd/mere/finance/docs/cli/command-reference.md`
- `/Users/nerd/mere/finance/docs/cli/examples.md`

## Safe Edit Boundaries

- CLI package: `/Users/nerd/mere/finance/packages/cli/*`
- CLI docs: `/Users/nerd/mere/finance/docs/cli/*`
- CLI tests: `/Users/nerd/mere/finance/packages/cli/tests/*`