A simple expense tracker application to manage your finances
npm install @markbonchi/expense-trackerBash
$ npm install @markbonchi/expense-tracker
`
---
$3
| command | description |
| :------------------------ | -----------------------------------------------: |
| add [options] | Add expense to save file |
| delete [options] | Deletes targeted task from list using ID |
| list [options] | Lists all relevant info about expenses |
| summary [options] | Sum of all the expenses |
| update [options] | Updates information about expenses |
| export-csv | Export expenses as .csv |
| set-budget [options] | Sets a budget limit to help manage expenses |
| list-budget [options] | Lists relevant information about saved budgets |
| update-budget [options] | Updates relevant information in specific budgets |
| delete-budget [options] | Deletes budget of specified month |
| help [command] | Display help for command |
---
$3
- add command saves expense to the an expense.json file
`Bash
expense-tracker add --description "Coffee" --amount 4.75 --category "Refreshments"
`
`
Output: Expense added successfully (ID: 4)
`
---
- delete command deletes expense entry from storage using ID
`Bash
expense-tracker delete --id 8
`
`
Output: Expense deleted successfuly
`
---
- list command displays a list of expenses in columns and rows
`Bash
expense-tracker list
`
`
Output:
ID Date Description Amount
1 2026-01-24 Bread for break... $1.25
2 2026-01-24 Bus ride to 711... $5.45
3 2026-01-24 Concert tickets... $56.99
4 2026-01-24 Coffee $4.75
`
---
- summary command displays the sum of all available expense
`Bash
expense-tracker summary --month 1
`
`
Output: Total expenses for January: $123.24
`
---
- update command updates specific date in the expense storage using ID
`Bash
expense-tracker update --id 4 --amount 6.75
`
- export-csv command exports expenses data as .csv
`Bash
expense-tracker export-csv --archive "filename"
`
`
Output: Expense exported to CSV file: filename.csv
`
---
- set-budget command Ssts a budget limit to help manage expenses
`Bash
expense-tracker set-budget --month 2 --budget 250
`
`
Output: Budget set to $250 for February 2026
`
- list-budget command lists relevant information about saved budgets
`Bash
expense-tracker list-budget
`
`
Output:
Month Year Budget
January 2026 100
February 2026 250
`
- update-budget command updates relevant information about specified budgets
`Bash
expense-tracker update-budget --month 2 --budget 350
`
- delete-budget command deletes budget of specified month
`Bash
expense-tracker delete-budget --month 2
`
`
Output: February 2026 budget deleted
``