sparebank1-context

sparebank1-context

Turn sb1 from "shows transactions" into "reasons over your money". This skill runs a brief interview over the user's real data, then stores the answers as a personal finance context that future finance sessions load up front. Read sparebank1-shared first for auth and flags.

The CLI already surfaces the data. This skill captures the personal meaning layer the bank cannot infer, and nothing more.

The privacy contract (read this first)

This skill's mechanism is public (it ships in a public repo and installs for anyone), but the answers are private personal data. Therefore:

• Write the context file to a user-owned path outside this repo. New profile contexts live at ~/.config/sparebank1-cli/contexts/<profile-hex>/context.md, where <profile-hex> is the UTF-8 bytes of the profile name encoded as lowercase hexadecimal. Override with SB1_CONTEXT_FILE for an explicitly selected context file.
• sb1 status --json reports legacyContext: true for the profile that adopted a previous single-profile login. For that profile, keep using the existing ~/.config/sparebank1-cli/context.md in place. Do not move, overwrite, or associate it with a different profile when the default changes.
• Never write answers, balances, account numbers, or counterparties into this repository, a commit, a PR, or any shared/cloud-synced location. Treat the file like the plaintext file secret store: keep it off backups and out of anything that syncs.
• Prefer account names + last 4 digits over full account numbers. Don't record figures the user didn't ask you to keep.
• The file is for this user's agent sessions. Don't paste its contents into chats, issues, or external services.

Resolve the path once at the start:

profile="<profile selected for this finance session>"
legacy_context="<legacyContext value from sb1 status --json>"
if [ "$legacy_context" = true ]; then
  default_ctx="$HOME/.config/sparebank1-cli/context.md"
else
  profile_hex="$(printf '%s' "$profile" | od -An -v -tx1 | tr -d ' \n')"
  default_ctx="$HOME/.config/sparebank1-cli/contexts/$profile_hex/context.md"
fi
ctx="${SB1_CONTEXT_FILE:-$default_ctx}"
mkdir -p "$(dirname "$ctx")"