Expense Tracker CLI

A simple command-line expense tracker written in Node.js that stores expenses in a CSV file (data.csv). It allows you to add, list, summarize, and delete expenses directly from the terminal.

rdsh project url

https://roadmap.sh/projects/expense-tracker

🚀 Features

• Add new expense with description and amount.
• List all expenses in a table-like format.
• View summary of total expenses.
• View monthly summary for a given month.
• Delete expense by ID.
• Data is stored in a lightweight CSV file (data.csv).

📦 Installation

1. Clone this repository or copy the script.

2. Make sure you have Node.js installed.

3. Save the script in a file, e.g. index.js.

4. Give it execute permission (Linux/macOS):

   chmod +x index.js

5. Run commands using:

   ./index.js <command>

📖 Usage

1. Add Expense

./index.js add --description "Coffee" --amount 3.5

✅ Adds a new expense with auto-generated ID and current date.

2. List All Expenses

./index.js list

✅ Displays all expenses in a readable format.

3. View Summary

./index.js summary

✅ Shows total amount spent.

4. View Monthly Summary

./index.js summary --month 10

✅ Shows total expenses for October (10).

5. Delete an Expense

./index.js delete --id 2

✅ Deletes the expense with ID 2.

📂 Data Format

Expenses are stored in data.csv with the following structure:

id,date,description,amount
1,10/3/2025,Coffee,3.5
2,10/3/2025,Books,12.99
3,10/3/2025,Groceries,45.67

🛠️ Example Session

./index.js add --description "Movie" --amount 12
./index.js add --description "Snacks" --amount 5.5
./index.js list
./index.js summary
./index.js summary --month 10
./index.js delete --id 2

📌 Notes

• CSV file is created automatically if not found.
• Dates are stored in MM/DD/YYYY format.
• IDs are incremental and based on the line count in data.csv.

📜 License

MIT License – free to use and modify.