{"id":21612671,"url":"https://github.com/alexstandiford/ynab-cli","last_synced_at":"2025-10-14T08:33:34.134Z","repository":{"id":196885699,"uuid":"198262691","full_name":"alexstandiford/ynab-cli","owner":"alexstandiford","description":"Generate Reports, and determine suggested account balances for your YNAB goals","archived":false,"fork":false,"pushed_at":"2019-07-23T01:28:32.000Z","size":8,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-14T08:33:30.597Z","etag":null,"topics":["cli","cli-app","finance","ynab","ynab-api"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alexstandiford.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2019-07-22T16:25:54.000Z","updated_at":"2023-03-08T00:33:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"aa24d66d-986d-43fe-8e4f-0e57fec0d3fb","html_url":"https://github.com/alexstandiford/ynab-cli","commit_stats":null,"previous_names":["alexstandiford/ynab-cli"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/alexstandiford/ynab-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexstandiford%2Fynab-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexstandiford%2Fynab-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexstandiford%2Fynab-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexstandiford%2Fynab-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexstandiford","download_url":"https://codeload.github.com/alexstandiford/ynab-cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexstandiford%2Fynab-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279018307,"owners_count":26086342,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","cli-app","finance","ynab","ynab-api"],"created_at":"2024-11-24T21:25:11.494Z","updated_at":"2025-10-14T08:33:34.099Z","avatar_url":"https://github.com/alexstandiford.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ynab-cli\nPersonal YNAB Toolkit\n\n## Installation\n\nTo install, follow these steps:\n\n1. Clone this repository\n\n`git clone git@github.com:alexstandiford/ynab-cli.git`\n\n2. Enter the directory, and install NPM packages\n\n`cd ynab-cli \u0026\u0026 npm i`\n\n3. Link the NPM package so you can run the commands in bash\n\n`npm link`\n\n4. Create a [YNAB access token](https://app.youneedabudget.com/settings/developer), and copy it to your clipboard.\n4. Create a `.env` file in the root of the directory, and add your YNAB key to the file.\n4. add two paramaters to your `.env` file, `YNAB_ACCESS_KEY` and `REPORT_DIR`. like this:\n```\nYNAB_ACCESS_KEY=add your key here\nREPORT_DIR=add a directory to save your reports here\nCATEGORIES_TO_SKIP=comma,separated,list,of,categories,to,exclude,from,your,reports\n```\n\nexample:\n\n```\nYNAB_ACCESS_KEY=48391432fhds893243243214321894fu84fq39f43fjids09032\nREPORT_DIR=/Users/alexstandiford/Documents/financial-reports\nCATEGORIES_TO_SKIP=Someday Maybe,Hidden Categories,Internal Master Category,Credit Card Payments,Monthly Bills,Online Subscriptions,Income,Other\n```\n\n## Usage\n\n### Generate a report\n\n`ynab generate-report \u003cbudget name\u003e --name --dir --skip`\n\nGenerates a plain text snapshot of the specified budget. I personally use this to send my wife a weekly snapshot\nof the status of our finances. This allows her to see what's going on without needing to learn how to navigate the app.\nIt also serves as a nice way to review what the finances were before I made changes later.\n\n1. *Budget Name*: The name of the budget to generate a report with.\n1. *name*: Overwrites file name\n1. *dir*: Overwrites file name and location to save this file\n1. *skip*: Comma separated list of categories to skip. You can also use \"Hidden Categories\" to auto-hide hidden categories.\n\n### Determine Suggested Short-Term and Long Term Savings Balances\n\n`ynab savings-balance \u003cbudget name\u003e`\n\nCalculates the suggested amount of money to help maximize potential earnings for money that is being saved for later use.\nThis works based on the goal date of each item in your budget. I run this at the beginning of each month after balancing\nmy budget to move money around as-needed.\n\n* If the budget's goal won't be completed in **more** than 2 months, it will add it to the _long-term savings_ total.\n* If the budget's goal will be completed sooner than that, it will add it to the _short-term savings_ goal.\n\nThe idea here is that if you don't need the money for more than 2 months, you can probably that cash into something that\ntakes a little longer to get back out, but has a higher interest rate than your savings account.\nSuch as Betterment's Smart Saver account are great for this.\n\nThe rest of the money should go into your savings account so you can get it quickly.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexstandiford%2Fynab-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexstandiford%2Fynab-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexstandiford%2Fynab-cli/lists"}