reconcli-for-ynab
TypeScript icon, indicating that this package has built-in type declarations

1.1.0 • Public • Published

ReconCLI for YNAB

Build Status NPM Version NPM Downloads Install Size

ReconCLI for YNAB - a CLI for quickly reconciling YNAB accounts

Works with YNAB

Features

  • Quickly reconcile your YNAB accounts from a terminal
  • Clear pending transactions and create a reconciliation transaction for the remaining difference, matching the YNAB app reconciliation flow
  • Fully local - your data stays between the YNAB API and your machine, no third party involved
  • Securely log in with a Personal Access Token
  • Retrieve the token from a source of your choice:
    • Direct input via command line parameter
    • Password managers:
  • Coin counting: if you use a coin counter, input the counts and calculate the new account balance automatically

Getting started

Prerequisites

Installation

Use the Node.js package manager of your choice to install as global:

npm i -g reconcli-for-ynab

Or run directly with npx:

npx reconcli-for-ynab

Usage

Usage: reconcli-for-ynab [options]

ReconCLI for YNAB - a CLI for quickly reconciling YNAB accounts

Options:
  -m, --token-mode <mode>         Token retrieval mode: direct input or 1Password CLI (choices: "direct", "1password", default: "direct")
  -t, --token <token>             YNAB Personal Access Token (for direct input mode)
  --op-item <item>                1Password: name of item (default: "YNAB")
  --op-field-label <field-label>  1Password: label of field containing the token (default: "personal access token")
  -b, --budget <budget>           Name of the YNAB budget (leave empty if there is only one budget in the account, or if the default budget is set)
  -a, --account <account>         Name of the YNAB account (ignored if there is only one account in the budget)
  -i, --input <mode>              Amount input mode: simple number, or coin counts for cash (choices: "number", "euro-coins", "usd-coins", "gbp-coins", default: "number")
  -h, --help                      display help for command

Upcoming features

  • Non-interactive mode for integrating into scripts
  • Add missing transactions during reconciliation
  • Support for more token retrieval methods:
    • Secure keyboard input
    • MacOS Keychain
    • ...

Built with

Acknowledgements

Inspired by Reconcile for YNAB.

Contributing

Issues and pull requests are welcome.

Local development

npm ci         # install dependencies
npm run start  # run with ts-node once
npm run watch  # run with ts-node and nodemon, restarting for *.ts file changes
npm test       # run tests
npm run build  # build into /dist
npm run local  # builds and installs the package on the local machine, then runs the binary

Package Sidebar

Install

npm i reconcli-for-ynab

Weekly Downloads

5

Version

1.1.0

License

MIT

Unpacked Size

84 kB

Total Files

41

Last publish

Collaborators

  • olex