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

---

$3

Bash

$ 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