Montte-erp/@montte/cli/budgets

Budget Goals

Budget goals set spending limits per category per month and optionally trigger an alert when a threshold is reached.

montte budgets list

List all budget goals for a given month.

montte budgets list --month 1 --year 2024
montte budgets list --month 3 --year 2024 --json

| Option | Required | Description | | --------- | -------- | ------------------- | | --month | Yes | Month number 1-12 | | --year | Yes | Four-digit year | | --json | No | Output raw JSON |

Output columns: id, category, limit, spent, percent

montte budgets get <id>

Get details of a single budget goal.

montte budgets get bgt_abc123
montte budgets get bgt_abc123 --json

montte budgets create

Create a monthly budget goal for a category.

montte budgets create \
  --category <category-id> \
  --month 1 \
  --year 2024 \
  --limit 500.00 \
  --alert 80

| Option | Required | Description | | ------------ | -------- | --------------------------------------------- | | --category | Yes | Category ID | | --month | Yes | Month 1-12 | | --year | Yes | Four-digit year | | --limit | Yes | Spending limit as decimal | | --alert | No | Alert threshold 1-100 (percentage of limit) | | --json | No | Output raw JSON |

montte budgets remove <id>

Delete a budget goal.

montte budgets remove bgt_abc123

Workflow Example

# Get your expense categories
montte categories list --type expense --json

# Set a R$500 budget for Alimentação in March 2024, alert at 80%
montte budgets create \
  --category cat_alimentacao \
  --month 3 \
  --year 2024 \
  --limit 500.00 \
  --alert 80

# Check progress mid-month
montte budgets list --month 3 --year 2024