Manual/Reference
When something goes wrong
Quick answers to the problems people actually hit. If yours isn't here, ask moh itself —
/ask-moh answers from this manual.
"The AI didn't reply"
moh treats an empty answer as a failure, not as success: it retries on your next provider
if you connected more than one, or shows a clear error naming what failed. Try again, or
pick another model with /model. A provider that returned nothing is skipped
for 15 minutes.
"It's going in a direction I don't like"
Just type — your message redirects it mid-task. Or press esc esc to
stop, then rephrase. If you want to try again from an earlier point, /tree lets
you branch from there and keeps both versions.
"The conversation is too long" or "switch refused"
The model's memory is full. Type /compact to summarise the older part, then
continue — or pick a model with a larger context window. moh refuses a switch to a model
that couldn't hold the conversation rather than breaking it.
"The provider test failed"
The setup shows the provider's own error in full: wrong key, wrong address, a plan without
access to that model. Every failed attempt is kept in
~/.moh/provider-test-failures.log (without your key) so you can check it later.
For subscriptions, moh provider login <name> logs in again.
"I closed the terminal by accident"
Reopen moh, pick the conversation from the list, continue. Nothing was lost.
"I deleted a conversation I needed"
$ moh trash list $ moh trash restore <id>
Within 30 days, it comes back exactly as it was.
"It feels slow"
- On Windows, keep projects on the Linux side of WSL (for example
~/projects), not under/mnt/c. - Try a faster model, or lower the thinking level with ctrl+y.
- A very long conversation is slower to process:
/compacthelps.
"The browser doesn't work"
Run moh browser status: it says what is missing. moh browser install
fetches it. On Linux, some systems need extra libraries — moh browser install
--with-deps installs them and may ask for your administrator password.
"An extension stopped loading"
If its file or manifest changed, moh asks for consent again before loading it. If it broke, moh shows why (missing manifest, an undeclared need, a version mismatch) and carries on without it.
Still stuck?
- Inside moh:
/ask-mohwith your question, or ctrl+h for the built-in manual. - Open an issue on GitHub — the project is open source, and feedback is genuinely welcome.
Written for moh 0.61. Inside moh, ctrl+h opens the built-in manual for your exact version.