finfocus-budget

FinFocus budgets

This skill is FinFocus-specific. Generic multi-tool budget workflows live in rshade/agent-skills, not here.

1. Put the limit in config

finfocus config init writes $PROJECT/.finfocus/config.hujson inside a Pulumi project, or ~/.finfocus/config.hujson otherwise. Project config overrides global config at the top-level key. A legacy config.yaml is migrated on read.

Set cost.budgets. A global amount is required when any provider, tag, or type budget is present. Amount 0 disables that scope. Only monthly is valid.

{
  "cost": {
    "budgets": {
      "global": {
        "amount": 500,
        "currency": "USD",
        "exit_on_threshold": true,
        "exit_code": 2,
        "alerts": [{ "threshold": 100, "type": "forecasted" }]
      }
    }
  }
}

Full schema, scoped examples, and validation errors: references/budget-config.md.

2. See whether spend is inside the limit

finfocus cost projected --pulumi-json plan.json
finfocus cost actual --pulumi-json plan.json --from 2026-10-01
finfocus overview

Table output prints a BUDGET STATUS section. JSON and NDJSON cost documents do not include that banner. Health bands:

• OK below 80%
• WARNING from 80% up to 90%
• CRITICAL from 90% up to 100%
• EXCEEDED at 100% and above

Several scopes roll up to the worst status.

Details: references/budget-health.md.

3. Fail CI only when asked

A global-only budget (no provider, tag, or type scope) exits through checkBudgetExit. That path fails when exit_on_threshold is true and a configured alert, including a forecasted alert, is exceeded. --exit-on-threshold and --exit-code override the global scope for that one command and write nothing to the config. FINFOCUS_BUDGET_EXIT_ON_THRESHOLD and FINFOCUS_BUDGET_EXIT_CODE set cost.budgets.global for the process, and a flag wins over them. Default is off, exit code 1.