budget

Manage monthly budgets and track spending

set

Set a monthly budget for a budgetable top-level category

bash

flouz budget set [category] [amount] [options]

Arguments:

Argument	Required	Description
`category`	No	budgetable category slug (e.g. necessities, discretionary, savings) — prompts if omitted
`amount`	No	budget amount in EUR (e.g. 2000) or percentage of income (e.g. 60%) — prompts if omitted

Options:

Flag	Description	Default
`-m, --month <YYYY-MM>`	target month (defaults to current)	—
`-d, --db <path>`	SQLite database path	—
`--defaults`	apply a default allocation across necessities, discretionary, and savings	—
`--necessities <value>`	necessities allocation for --defaults (e.g. 30%)	`50%`
`--discretionary <value>`	discretionary allocation for --defaults (e.g. 30%)	`30%`
`--savings <value>`	savings allocation for --defaults (e.g. 20%)	`20%`

List budgets for a given month

bash

flouz budget list [options]

Options:

Flag	Description	Default
`-m, --month <YYYY-MM>`	target month (defaults to current)	—
`-d, --db <path>`	SQLite database path	—

Check budget progress for the month

bash

flouz budget check [options]

Options:

Flag	Description	Default
`-m, --month <YYYY-MM>`	target month (defaults to current)	—
`-d, --db <path>`	SQLite database path	—

Manage the monthly income total

bash

flouz budget total

Set the monthly income total (auto-detects from income if no amount given)

bash

flouz budget total set [amount] [options]

Arguments:

Argument	Required	Description
`amount`	No	monthly income in EUR (prompts interactively if omitted)

Options:

Flag	Description	Default
`-m, --month <YYYY-MM>`	target month (defaults to current)	—
`-d, --db <path>`	SQLite database path	—

Show the monthly income total

bash

flouz budget total show [options]

Options:

Flag	Description	Default
`-m, --month <YYYY-MM>`	target month (defaults to current)	—
`-d, --db <path>`	SQLite database path	—