FAQ
macOS says the app cannot be opened
Section titled “macOS says the app cannot be opened”The preview is not notarized yet. Use System Settings → Privacy & Security → Open Anyway; see Install.
An agent is “not found”
Section titled “An agent is “not found””Session Bay checks PATH and common install locations, including macOS version-manager directories. Try Settings → Sources and tools → Detect again. If the CLI is still missing, set Executable path to an absolute path, for example the output of which claude in your shell.
A terminal cannot find node or npm
Section titled “A terminal cannot find node or npm”0.3.0 prevents new terminals from inheriting the launcher’s nvm and npm session state. A broker started before the fix keeps its old environment until it restarts. Use Restart background service in the version-mismatch notice and confirm the running-agent count; this ends all running agents. Closing the window only detaches. Newer brokers update automatically once their running agents end. Also check that your shell profile initializes your version manager.
My history is empty
Section titled “My history is empty”Check Settings → Sources and tools → History sources for that agent. Choose Detect history sources, save, and let the scan finish. Only sessions written by the agent’s CLI are supported.
A project moved to another folder
Section titled “A project moved to another folder”Choose Relocate next to the project path. New processes start in the new location; the original history is not rewritten.
Does closing Session Bay stop my agents?
Section titled “Does closing Session Bay stop my agents?”No. Agents and terminals keep running in the background and reattach when you reopen Session Bay. Use Stop on a pane to end it.
Can I use Session Bay in Chinese?
Section titled “Can I use Session Bay in Chinese?”Yes. Settings → Appearance and defaults → Language.
Where do I report a bug?
Section titled “Where do I report a bug?”Open an issue. Please do not paste real conversations or tokens.