Troubleshooting
Find the symptom, check the cause and follow the fix.
What this page covers
OutcomeNarrow a problem to one symptom, one check and a repeatable result.
Before you beginKeep the exact message or symptom in view. Avoid changing several settings at once.
Follow these steps
Find your symptom below and check the surface it names before changing a setting. Most of what looks like a hang is something waiting for an answer.
Change one thing at a time, then repeat the same short request. A consistent request is the only way to tell whether the fix worked or the problem simply moved.
If you write to us, say what happened, what you expected and what you already tried. Read any transcript or log first — they carry your words and your project details.
Example
Repeat the same short request after each change.
A consistent request helps you tell whether a different microphone, resumed conversation or answered permission actually resolved the problem.
Give support a useful starting point
Include the symptom, what you expected and the steps you already tried. If it concerns one task, say whether it is queued, running, blocked or finished.
Read transcripts and logs before sharing them: they may contain your words and project details. The contact page gives you both a form and the current email address.
Find your symptom
It cannot hear me.
Cause: Microphone permission, the wrong input device or a muted microphone can prevent speech from reaching Ginu.
Fix: Check macOS microphone permission and the selected input. On Home, check the mic control separately from the speaker control. Resume if paused.
It cuts me off, or waits too long.
Cause: The turn-ending policy combines a base pause with learned rhythm and sentence completion. A changing speaking pattern can need adjustment.
Fix: Try a complete sentence and tell Ginu when it ended your turn too soon. If it keeps happening, open Settings → Voice and adjust **Patience**: more patient for a longer pause before Ginu takes its turn.
It talks over itself, or answers itself.
Cause: Speaker output can return through the microphone. A wireless headset used for both input and output can also switch macOS into call quality.
Fix: Use earphones for output and the built-in or an external microphone for input. Recheck the selected devices after reconnecting the headset.
It seems to have hung.
Cause: An agent may be waiting for a permission decision, or the conversation may be paused.
Fix: Inspect Attention and the agent terminal. Read the requested action, then answer by voice, type /approve or /deny, or use its on-screen controls. Resume the conversation if paused.
Shell says tmux is missing.
Cause: Persistent terminal sessions depend on tmux being available to the process running Ginu.
Fix: Install tmux using your normal setup, check that the process can find it and restart Ginu. Other surfaces can still work without Shell.
Memory is empty and projects are missing.
Cause: The memory vault needs git and a readable, writable storage location. A different data location can also show a different vault.
Fix: Read the startup error, check git is available and check that Ginu can read and write its data folder. Restore access to the existing vault before creating a replacement.
The phone will not pair, or it dropped.
Cause: The pairing code may have expired, the session window may have ended, or the computer may have restarted. Five wrong guesses burn that window.
Fix: Keep the computer running and check Settings → Connections. Open a fresh window and scan its code if pairing is expired or burned. A restart needs a fresh scan.
The first launch is slow.
Cause: The speech models must download when absent and load before voice is ready. A cold start takes longer than a warm restart.
Fix: Let setup and model loading finish. The prerequisites screen shows how much is still downloading. Give loading time to finish before restarting repeatedly.
It ignores me, or answers only some voices.
Cause: Owner detection is on and judges speech against your recorded voiceprint.
Fix: See Owner detection: re-record your voiceprint, or turn it off. Typing always works.
It misheard a word it should know.
Cause: Unusual names and project vocabulary may not be recognised reliably by the speech model.
Fix: Open Vocabulary under Extensions. Add the term and check it with a short phrase before relying on it in a longer request.
Notes
- A stopped worker is not proof that its task succeeded. Read the result and inspect its changes.
- The installed app’s status and error message are more specific than a general troubleshooting entry.
Check
You can describe what happened, the setting you checked and the result of the same request afterward.