https://github.com/shubham-kv/expenses-cli

cli-tool expense-tracker expenses finance finance-management nodejs

Last synced: 7 months ago
JSON representation

CLI tool to manage expenses.

Host: GitHub
URL: https://github.com/shubham-kv/expenses-cli
Owner: shubham-kv
Created: 2025-02-28T11:55:04.000Z (8 months ago)
Default Branch: main
Last Pushed: 2025-03-25T16:16:34.000Z (7 months ago)
Last Synced: 2025-03-25T17:27:08.541Z (7 months ago)
Topics: cli-tool, expense-tracker, expenses, finance, finance-management, nodejs
Language: TypeScript
Homepage:
Size: 233 KB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

README

## Features

- Add, edit, delete & list all your expenses
- View summary of your total expenses by month or filter for a specific month

## Getting Started

Install the package globally with `npm` (or `yarn`, etc.)

```bash
npm install --global @shubhamkv/expenses-cli
```

## Usage

Add your expenses with the `expenses add` command:

```bash
expenses add Lunch --amount 20
```

Optionally include a description with the `-d` or `--description` option:

```bash
expenses add Lunch --amount 20 --description "Lunch at a restaurant near office"
```

View all of your expenses with `expenses list`:

```bash
expenses list
```

Update `name`, `amount` & `description` of the expense with `expenses edit`
command passing in the expense's id.

If `7LNjEL1K` is the id of the expense you would do the following to update it's amount:

```bash
expenses edit 7LNjEL1K --amount 25
```

Delete unwanted ones with the `expenses delete` command:

```bash
expenses delete 7LNjEL1S
```

Get a monthly summary of your expenses:

```bash
expenses summary
```

## Credits

Inspired from [Roadmap.sh | Expense tracker](https://roadmap.sh/projects/expense-tracker).