https://github.com/icyflame/terminal-wallet
Manage your wallet, from the terminal
https://github.com/icyflame/terminal-wallet
cli expense-tracker expenses-manager manager nodejs wallet
Last synced: 4 months ago
JSON representation
Manage your wallet, from the terminal
- Host: GitHub
- URL: https://github.com/icyflame/terminal-wallet
- Owner: icyflame
- License: mit
- Created: 2015-07-06T10:54:47.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2017-10-03T18:02:23.000Z (over 8 years ago)
- Last Synced: 2025-10-26T20:45:38.788Z (8 months ago)
- Topics: cli, expense-tracker, expenses-manager, manager, nodejs, wallet
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/terminal-wallet
- Size: 279 KB
- Stars: 8
- Watchers: 1
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
# terminal-wallet
> Manage your wallet, from the terminal
[](https://travis-ci.org/icyflame/terminal-wallet)
[](https://github.com/Flet/semistandard)
[](https://nodejs.org/en/download/)
Project page (for screenshots and explanation): [terminal-wallet](http://icyflame.github.io/terminal-wallet/)
### Why?
Not a long time ago, I used a Google Sheet to manage my wallet, and as a matter of
fact, it got tedious soon. Opening the browser, waiting for the page to load,
and not being able to update stuff when there's no connectivity, all of that
has led me to write this small CLI application, that can be used by anyone to
manage their wallet right from the terminal.
## CLI
```
$ npm install --global terminal-wallet
```
```
$ wallet --help
Usage
wallet debit [-c ][-d ]
wallet credit [-c ][-d ]
wallet export
wallet clear
Example
wallet debit 10 'Breakfast, Coffee at Canteen' -c 'Food'
✔ Expense written to file!
wallet credit 2000 'Salary for July 2015' -c 'Salary'
✔ Expense written to file!
wallet export
✔ Your file can be found at
/home/siddharth/.local/share/wallet/exported/export-2015-07-06.csv
wallet clear
✔ Account closed. Expense details have been exported to :-
/home/siddharth/.local/share/wallet/closed/closed-2015-07-06.csv
Prepared a clean slate, for the next accounting period.
wallet-open # or just wo
This will open the wallet csv file in a less session, in a
in a reverse chronographic order, which is convenient for viewing
latest transactions
Options
-c Category ; Default: '' ; Optional
-d yyyy-mm-dd ; Default: Today's date; Optional
```
## CLI
##### `wallet debit [-c ] [-d date]`
_`Made a purchase of for under the category `_
Add a debit entry to your account book. Date can be written as, `yesterday`, `day before yesterday`,
etc. Check [this list](https://github.com/icyflame/relative-date-reverse/blob/master/supported.md) for
supported date phrases.
##### `wallet credit [-c ]`
` credited to the wallet from under the category `
Add a credit entry to your account book.
##### `wallet export`
Export the current state of your account book to a timestamped file.
(Path to the file will be printed when the command completes execution)
##### `wallet clear`
Close the account for the last period, and start with a clean slate.
The expenses will be exported to a timestamped file, and can be retrieved.
(Typically, This operation can be used at the end of each month, or any period that is convenient for the user.)
##### `wallet stash `
Remove money from wallet and stash it for later use.
##### `wallet unstash `
Withdraw money from your stash, and credit it to the wallet.
##### `wallet file_path`
The filepath of the CSV file in which all the expenses are being stored.
##### `wallet-open` or just `wo`
Open the CSV file where everything is stored in a reverse chronological order
which is convenient for viewing latest credit / debit transactions.
## License
MIT © [Siddharth Kannan](http://icyflame.github.io)