Overview
gbudget is a personal CLI budget application that lets you track income and expenses directly from the terminal. It optionally generates monthly markdown statements in your Obsidian vault.
Data Storage
All data is stored locally using SQLite. The database and config file locations vary by platform.
- Linux/Mac -
~/.local/share/gbudget/budget.db - Windows -
%APPDATA%/gbudget/budget.db
Installation
Clone the repo and run gbudget directly, or install globally via pip install -e ..
Commands
gbudget init- First-time setup.gbudget add AMOUNT DESC- Add a transaction.gbudget list- Show transactions.gbudget summary- Show totals.gbudget export- Regenerate a monthly statement.
