Expense Tracker

Track your sending directly from your command line
A fast and efficient CLI tool for logging your expenses and managing your finances

roadmap.sh

Installation

$ npm install @markbonchi/expense-tracker

Implementation

| 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 |

Examples

• add command saves expense to the an expense.json file

 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

expense-tracker delete --id 8

Output: Expense deleted successfuly

• list command displays a list of expenses in columns and rows

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

expense-tracker summary --month 1

Output: Total expenses for January: $123.24

• update command updates specific date in the expense storage using ID

expense-tracker update --id 4 --amount 6.75

• export-csv command exports expenses data as .csv

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

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

expense-tracker list-budget

Output:
Month      Year    Budget
January    2026    100
February   2026    250

• update-budget command updates relevant information about specified budgets

expense-tracker update-budget --month 2 --budget 350

• delete-budget command deletes budget of specified month

expense-tracker delete-budget --month 2

Output: February 2026 budget deleted