| Crates.io | bgt-cli |
| lib.rs | bgt-cli |
| version | 0.2.2 |
| created_at | 2025-06-19 21:42:44.075688+00 |
| updated_at | 2025-08-01 17:43:14.828434+00 |
| description | A simple Rust CLI tool to manage monthly budgets using TOML config files |
| homepage | https://github.com/lst1000/bgt-cli |
| repository | https://github.com/lst1000/bgt-cli |
| max_upload_size | |
| id | 1718863 |
| size | 23,310 |
bgt-cli is a command-line tool for managing and tracking personal budgets using monthly TOML configuration files.
It calculates gross and net income, tax deductions, total expenses, and surplus. Configuration is separated by month (YYYY-MM.toml) and stored in the system config directory. You can create and edit configuration files directly via the command line.
~/.config/bgt-cli/2025-08.toml on Linux or ~/Library/Application Support/bgt-cli/2025-08.toml on macOS)-c, or edit with -ebgt-cli [-f YYYY-MM | -c YYYY-MM | -e YYYY-MM | -h]
-f YYYY-MM
Load and display budget information for the given month.
-c YYYY-MM
Create a new configuration file for the given month. If it already exists, an error is shown.
-e YYYY-MM
Edit the configuration file for the given month using $EDITOR, or fall back to nano. If the file does not exist, it is created first.
-h
Display the help message.
The program expects a TOML file named YYYY-MM.toml stored in your system’s config directory.
Example paths:
~/.config/bgt-cli/2025-08.toml~/Library/Application Support/bgt-cli/2025-08.toml%APPDATA%\bgt-cli\2025-08.tomlThis file should include the following sections:
Install using Cargo:
cargo install bgt-cli
Written by Laurence Stock-Tully