Use this skill when the user has lost their AxonFlow plugin credentials —
typically because ~/.config/axonflow/try-registration.json is missing,
unreadable, or bound to an account they no longer want to use — and needs
to recover access via the email the tenant was originally registered with.
The flow is implemented in scripts/recover-credentials.sh (a shell helper
the user invokes from a terminal). Cursor itself does not run plugin code
in a long-lived process and cannot prompt the user for an email + magic-link
token from its chat UI — running the script in the integrated terminal is
the right surface.
What to do
- Tell the user what's about to happen: "I'll run
scripts/recover-credentials.shin your terminal. It will ask for the email you registered with, send a magic link, then ask you to paste the token from the link." - Invoke the script via the Shell tool:
bash scripts/recover-credentials.sh(run from the plugin's install directory, typically~/.cursor/plugins/local/axonflow-cursor-plugin). - The script writes the recovered credentials to
~/.config/axonflow/try-registration.json(mode 0600). The community-saas bootstrap picks them up on the next governed tool call — no shell re-export, no Cursor reload required.
What this skill does NOT do
- It does not create a new account from scratch — that path is automatic
via the community-saas bootstrap when neither
AXONFLOW_ENDPOINTnorAXONFLOW_AUTHis set. - It does not move credentials between machines — recovery is per-email, not per-host. To set up a new machine for the same tenant, run recovery there too.
- It does not recover Pro license tokens (
AXONFLOW_LICENSE_TOKEN) — those are the buyer's responsibility, delivered to the email at Stripe checkout. If the Pro user lost their license token, they recover it from the originalfrom=billing@getaxonflow.comemail rather than this flow.
When to suggest it
Suggest this skill when the user reports any of:
- "I'm getting AxonFlow auth errors and I don't know my credentials"
- "I deleted ~/.config/axonflow"
- "I switched to a new laptop and the plugin won't auth"
- "The plugin says my credentials file has unsafe permissions"
Do NOT suggest it for:
- "What is my AxonFlow tenant ID?" — point them at
cat ~/.config/axonflow/try-registration.json | jq .tenant_idinstead. - "I want to upgrade to Pro" — point them at the Stripe checkout surface; recovery is for free-tier credential loss only.