Troubleshooting
The things that actually go wrong, and what they mean.
A tool cannot find something I just saved
Give it a minute.
Exact words are searchable the moment something is stored, but matching by meaning — "how often can we deploy" finding "deploys are capped at five a month", needs the memory to be indexed first. That usually takes between half a minute and a minute, and now and then a little longer.
If it is still missing after two minutes, check that the tool is asking from the right origin.
A tool finds nothing at all
Run the check
npx @get-hivemind/cli doctorThis tests the server, your key, every tool's connection and the Claude Code hooks, and prints the command that fixes anything not passing.
Check which account it is on
npx @get-hivemind/cli statusThis shows the account each tool is using, and flags any that are on a different key. A tool on the wrong credential sees none of your memories and gives no other clue why, it looks exactly like an empty account.
Restart the tool
Most read their configuration once at startup. init cannot make a running
editor re-read it.
Confirm the memory is there
Open Memories in the dashboard. If it is not listed, it was never stored; if it is, the problem is retrieval rather than capture.
Retrieval returns nothing for a question I expect it to answer
Sometimes correct. Nothing is returned when nothing is relevant enough, and an empty payload beats a plausible-looking irrelevant one.
To see the reasoning, run the query in the dashboard's Retrieval view. It
shows what was considered and what was discarded. If good candidates are being
cut, lower threshold; if unrelated ones are getting through, raise it.
The browser extension is not doing anything
- Is the site enabled? Well-known chat sites work out of the box; anywhere else needs Enable here in the extension, granting access to that one origin.
- Did you reload the page after enabling it? A newly granted site only applies to fresh loads.
- Nothing is added to a message unless you start a chat from the card or type
@remind. If the card never appears, check the toggle in the extension, and that you have a thread with something in it.
Sign-in from the command line fails
If the browser lands on connection refused, the command had already stopped
waiting. Run init again and finish signing in without leaving it, the
terminal window has to stay open, because that is what the browser returns to.
On a machine with no browser, a server, a container, an SSH session, pass a key instead:
npx @get-hivemind/cli init --key hm_live_...Create one under Connected tools in the dashboard.
I hit my monthly limit
Reading, searching and exporting keep working. Only new memories stop.
Existing memories are never touched by a limit, and nothing is deleted. Upgrade or wait for the month to roll over.
A task says it couldn't be checked
Free includes 30 checks a month. A check is Hivemind reading the pages a finished task cites, or asking another tool to review it. When the month's checks are used up, finished work says "Couldn't check" on its receipt and the count starts again on the 1st (UTC). Tasks keep working, and checks your own runner records on your machine are not counted. Asking another tool to review is part of Pro.
Something else
This is early access, and the most useful thing you can send is what you expected versus what happened. If retrieval was involved, the Retrieval view's output tells us far more than a description does.