set up a browser extension that lets me chat with my agent from zen browser. zen is firefox-based so firefox extensions work, but it threw an error about background service workers being disabled. firefox uses background scripts instead of service workers which is a chrome mv3 thing. quick fix was editing the manifest json to change background.service_worker to background.scripts and reload. then the extension couldn't find the gateway because it was scanning localhost but the agent runs on a remote server. had to point it to the tailscale ip and configure the gateway to accept external connections by binding to zero dot zero dot zero dot zero instead of localhost only.
the dashboard runs on a different port than the api server. the gateway's api is on port eight six four two but the web dashboard is on nine one one nine. the extension needs to point to the dashboard url and sign in through a browser tab. at some point hermes removed the ability for the insecure flag to bypass authentication as a security hardening measure, so the dashboard now requires basic auth with username and password. once that was configured the login page worked. the extension still showed chat unavailable because it was pointing to the dashboard port instead of the api server port. changed it to point to the api server with an api key and the health check passed.
during all this three mcp servers failed to connect — mymind, trek, and whoop. the mymind server couldn't be found because the python package wasn't installed in its virtualenv, just running the module with dash m. trek had transient sse stream disconnections that resolved on retry. whoop had a zombie process holding its callback port from a previous session. the lesson was to check the stderr logs first instead of guessing, and that procedural troubleshooting knowledge belongs in a skill not in memory. created a diagnostics skill with all the gotchas — port conflicts, missing package installs, transient errors, zombie processes from test calls. next time something breaks i'll go straight to the logs.