Troubleshooting

Agents and consoles#

A console says the agent was not found on PATH#

The CLI is not where Symvibe looks. Check that it runs in Terminal, then set its path in Settings›Agents›Agent executables if it lives outside the usual folders, and press Restart on the console.

Consoles never show NEEDS YOU or READY#

Those states come from live agent status, which is off by default and covers Claude Code and Codex. Turn it on, choose Trust when Codex asks, then restart consoles that were already running.

A new console is stuck on a trust or sign-in question#

Symvibe never answers those for you. Click into the console and answer it, or sign in with the CLI's own login command.

No resume offer after reopening#

Resume is offered for Claude Code, Codex, Gemini and OpenCode, with Settings›General›Resume agent chats on. Only a console that had a conversation gets the offer, and Claude Code and Codex also need that session saved on disk. Gemini and OpenCode offer it only on the console that chatted last. Grok, shells and other agents start fresh.

Orders and voice#

Holding Space does nothing#

• A console or text field has the keyboard: click empty canvas first.
• The microphone is blocked: allow Symvibe in System Settings›Privacy & Security›Microphone.
• The speech model is still downloading on first use: wait for it, then hold Space again.
• Settings›Voice›Hold Space to talk is off.

Holding Fn opens the emoji picker#

Set System Settings›Keyboard›Press Globe key to to Do Nothing, or pick Right ⌘ or Right Option in Settings›Voice›Hold to dictate.

An order did not reach a console#

• It is a plain shell, or the agent exited back to its shell. Orders only go to running agents.
• The agent is showing a permission prompt or a question. The order waits up to 15 minutes for your answer.
• The console is paused. Resume it.
• You gave the order on an orchestrator card that is not wired to that console.

The thread says it sent nothing to the agents#

• The planner didn't answer: the planner could not be reached, or was busy or rate limiting. Try again in a moment, or start the order with the console or group it is for.
• Without the planner I can't write or split that order: your monthly credits are used up, the planner refused your account, or the order was over 600 characters. Plain orders still work: shorten the order, or address agents with @ and give the task as they should read it. Credits shows your balance.

Access and updates#

The app shows Let's check your access#

Usually the connection. Choose Check my access again, or Sign in again if that is the button shown; if the app asks you to update, install the latest version. If it persists, open your account dashboard to confirm the subscription is active, and make sure your email is verified.

An update is waiting but not installing#

Press Restart on the Update ready pill, or quit Symvibe normally; it installs on the way out. You can always download the current installer from your dashboard.

Studios#

A document or diagram stops on a trust or sign-in question#

The CLI asked something Symvibe will not answer for you. Open a console of that CLI in the repo, answer it there (trust the folder, or sign in: run /login in Claude Code, or use the CLI's own sign-in), then try again.

A document was stopped after several minutes#

Runs have a time limit by effort. Choose Quick, or ask for something narrower.

Web tiles and Git#

A web tile keeps waiting for the dev server#

Nothing answers on that port yet. Start the server in a console, check the port in its output, then press Retry now.

A push fails or hangs#

• Git never asks for credentials inside the app. Make sure your SSH key is loaded or your credential helper is set up, and that a push works in Terminal.
• Files over 100 MB are rejected by GitHub; see Git on the board.
• If the branches diverged, merge in a console.

Report a problem#

Found a bug? in the bottom right corner of the board opens the support page. Include the version from Settings›About and what you did. If the app froze, the file ~/Library/Application Support/Hypervibe/Diagnostics/hitches.log helps us; it stays on your Mac unless you send it. You can also write to hello@symvibe.com or ask in the Discord.

Keep going#