financy-setup

financy setup

Get the financy CLI configured and verified for this user. When you are done, financy status exits 0 and every other financy command works.

Minimum CLI version: 0.1.0

Guardrails

These are not optional and they apply to every step below.

• Never handle the client secret at all. Do not ask the user to paste it into the conversation, and never place it in a command you run — a command you run is recorded in the transcript, and it is visible in shell history and to anything that can list processes. The user types the secret into financy setup, which masks it at the prompt; you never see it. If the user pastes it anyway, do not repeat it, do not use it in a command, and tell them to rotate it in Financy → Settings → API. Never print it, read it back for confirmation, or include it in a summary, and never cat the config file. If setup warns that the input is not masked (a terminal where Node cannot hide input, e.g. Git Bash / mintty, where stdin is a pipe), tell the user to run it in PowerShell or Windows Terminal instead of typing the secret in the clear.
• Confirm before spending credits. financy refresh costs 20 credits per run. Never run it without the user explicitly agreeing to that cost in this conversation.
• Exit code 4 means the plan, not the credentials. The credentials are valid but the account is not on a paid plan. Do not retry, do not suggest re-entering the credentials — point the user at the upgrade path and stop.

What the user needs before you start

The financy data API is a paid feature. To finish this skill the user must have:

1. A registered Financy account at https://open-finance.ai.
2. A paid plan — Starter, Pro, or Ultra. The data API is not available on the free plan.
3. Three values from the Financy app → Settings → API: clientId, clientSecret, and userId.

If the user does not have a paid plan yet, say so up front rather than letting them collect credentials that will fail at the last step.