Skip to content

The sessions daemon

Sessions belong to a background daemon, not the web server or the browser tab. Closing the tab or restarting the web server leaves every session running with its scrollback, and any number of browser tabs can watch the same sessions.

When a new build is ready, Restart on the Nodes page restarts the daemon. Claude sessions carry on their conversations, with fresh scrollback; run sessions come back as not-restored cards you can retry. To check on, stop or clear out the daemon, use assist daemon.

One daemon holds at most 24 live sessions, and starting another past that is refused. A restart also brings back at most that many. Change the ceiling with:

Terminal window
assist config set sessions.maxLive 32

The web server and daemon run on whichever Node.js launched assist, and so do the agents they start. To pin them to another, give a version or range installed with fnm, nvm or volta, or the path to a Node.js binary:

Terminal window
assist config set sessions.nodeVersion 24.22.1 --node