Skip to content
Thrum

Update Thrum

Free

Do this each time you install a new version of Thrum. On a first install, you don’t need this page: go on to the quickstart.

The daemon is Thrum’s background process. After you install a new version of Thrum, the daemon keeps running the old version until it restarts. Each repository with Thrum has its own daemon, so do this in each one. To restart it:

  1. Open My Inbox in Thrum’s web UI, the page you open in your browser to see your agents and their messages.

  2. Send your coordinator, the agent you talk to, this message:

    Restart the Thrum daemon, then check it and tell me how it looks.

  3. Wait for the coordinator’s reply. It restarts the daemon, checks it, and replies. Its wording will differ from this example:

    Coordinator: The daemon restarted and looks healthy.
                 - Version: the one you installed.
                 - Uptime: 31 seconds, so it is a fresh start.
                 - Startup: finished with no errors.
                 - Crashes: none.
                 - Agents: all still listed.

  4. Check it worked. The bar at the bottom of the web UI shows the daemon’s version after v, and its uptime after up:, for example up:35s. After the restart, the version is the one thrum --version prints, and the uptime starts again from a few seconds. A large uptime means the restart did not happen, so ask your coordinator to try again. If the reply mentions an error, see Common errors.

If you use Codex agents, also ask your coordinator to refresh the Codex setup in your existing Codex worktrees, the separate checkouts those agents work in. See Use Thrum with Codex.

If you also update Thrum’s plugin, the add-on that connects your AI tool to Thrum (Install Thrum shows it for Claude Code), run thrum roles refresh, then thrum roles deploy. This updates your agents’ instructions to match the new version. If it prints a note that some roles have no model tier entry, you can ignore it: those agents run on your default model.

No coordinator running? Stop and start the daemon yourself with thrum daemon stop, then thrum daemon start, then run thrum daemon status to check that it is running.

Next steps

Section titled “Next steps”