Troubleshooting

Fixes for the things that actually go wrong, grouped by what you were trying to do.

Connecting

The sign-in email never arrived

Check spam. The 6-digit code expires, so if you requested several, use the newest one. Request a fresh code if you need to.

My AI does not show any CyberFox Brain tools

In Claude, check Settings, then Connectors, and confirm the connector is present and enabled for the conversation. In ChatGPT, the connector is never attached automatically: in every conversation, open the composer’s + menu, choose Developer mode, and select the app.

The tools are there but they are the old ones

In ChatGPT, open the app’s details and choose Refresh to re-pull the tool list. In Claude, remove and re-add the connector.

list_brains returns nothing, but I have a brain

You are almost certainly signed in to the connector with a different email than the web app. Email is the identity key. Sign out of the connector, reconnect, and use the same address.

Using a brain

Adding someone returns “not registered”

A person has to sign in once, themselves, before an owner can add them. Have them connect first, then add their email from Access.

I was added to a brain but cannot see it

Reconnect the connector so it re-reads your membership, and confirm the owner used the exact email you sign in with.

My AI answers without checking my brain

A model decides for itself when to call a tool. Either say so explicitly (“check my CyberFox brain first”), or set a standing instruction in your host so it remembers. See the install page’s default context section.

An agent overwrote a note

Nothing is lost. Every write is versioned. Ask your AI to call get_history on the note, read_version to see the one you want, and restore_version to roll it back. The current content is saved to history first, so a restore can itself be undone.

A note is too big for my AI to read in one go

Ask it to read an outline first, then read the range it needs, and to change the note with edit_note or find_in_note rather than rewriting the whole thing.

I want my data out

Open the brain’s Data page in the web app and export a zip of plain markdown, one file per note. Nothing is proprietary. The same page imports a folder of markdown back in, with a preview of what will be created, skipped, or overwritten before anything is written.

Still stuck? Email hello@cyberfoxai.com.