Troubleshooting
The things that actually go wrong, and what they mean.
A tool cannot find something I just saved
Give it about thirty seconds.
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 takes a little under half a minute.
If it is still missing after a minute, check that the tool is asking from the right origin.
A tool finds nothing at all
Check which account it is on
npx 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.
- Is injection switched on? There is a toggle in the extension.
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 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.
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.