Where state lives

• ~/.config/kelpie/config.json - the settings.
• ~/.cache/kelpie/ - everything kelpie remembers: session names, dismissals and snoozes, notes, pull request facts, which release you have seen, when it last checked for an update, pasted chat attachments, and while you are sharing with a phone, the key that signs its cookie (owner-only, deleted when you stop).

Nothing under ~/.claude, or any other agent’s directory, is ever modified. Kelpie reads those and writes only the two paths above.

Two boards can run at once, for instance a second one started with --cwd on another port. Both write to ~/.cache/kelpie, and each re-reads before it changes anything, so neither undoes the other.