Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/danielbachhuber/harvest-monthly-expenses
CLI to summarize monthly Harvest expenses based on category
https://github.com/danielbachhuber/harvest-monthly-expenses
Last synced: 19 days ago
JSON representation
CLI to summarize monthly Harvest expenses based on category
- Host: GitHub
- URL: https://github.com/danielbachhuber/harvest-monthly-expenses
- Owner: danielbachhuber
- Created: 2019-08-21T21:24:00.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-05-09T12:42:05.000Z (over 1 year ago)
- Last Synced: 2024-10-09T11:38:07.603Z (30 days ago)
- Language: JavaScript
- Homepage:
- Size: 81.1 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Welcome to harvest-monthly-expenses 👋
Summarize your monthly Harvest expenses on the command line!
Yes, you can do this in Excel too. I decided to write some code instead.
## Install
To install, simply run:
```sh
npm install harvest-monthly-expenses
```
You'll also need to obtain a [Harvest Personal Access Token](https://help.getharvest.com/api-v2/authentication-api/authentication/authentication/#personal-access-tokens).
## Usage
First, set your Harvest authentication details as environment variables:
```sh
export HARVEST_ACCESS_TOKEN=
export HARVEST_ACCOUNT_ID=
```
By default, the current month's expenses are displayed:
```sh
$ harvest-monthly-expenses
Expense Category,August 2019
Education,$20.00
Professional Organization,$0.00
Subscriptions,$8.00
Contractors,$0.00
[...]
```
Control the date range with the `--start-date=` and `--end-date=` arguments:
```sh
$ harvest-monthly-expenses --start-date=2019-01-01 --end-date=2019-03-31
Expense Category,March 2019,February 2019,January 2019
Education,$0.00,$0.00,$56.99
Professional Organization,$0.00,$0.00,$99.00
Subscriptions,$0.00,$14.95,$280.00
Contractors,$0.00,$0.00,$0.00
```
Or, filter expenses to a specific client with the `--client-id=` argument.
## Author
👤 **Daniel Bachhuber**
* Github: [@danielbachhuber](https://github.com/danielbachhuber)
## 🤝 Contributing
Contributions, issues and feature requests are welcome!
Feel free to check [issues page](https://github.com/danielbachhuber/harvest-monthly-expenses/issues).
## Show your support
Give a ⭐️ if this project helped you!