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. Closing the window does not restart the broker; a Mac restart does. 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.