Updates

claude-code-ui checks npm for a new version when it starts and once a day, and can update itself.

How to update from the app

1. When a new version exists, a notice shows Update available.
2. Click Update and restart. It installs the new version while your sessions keep running.
3. It restarts once no session is working. Restart now does not wait: it ends running turns and closes terminals.
4. The page reconnects by itself. Your sessions come back.

Not yet hides the notice until the next version.

Check for updates yourself

Open Settings › About (Help & about). The Updates row shows the version you can install, even after Not yet. Click Check for updates to ask npm now, then Update and restart.

From the command palette, run Check for updates. A new version brings the notice back. Otherwise a message says you have the latest version.

How to update from a terminal

claude-ui update

The next start runs the new version.

Good to know

• Updates go into the versions/ folder of the config folder. No global install and no sudo needed. It also works when you run it with npx.
• npm i -g claude-code-ui@latest still works too.
• If a new version does not start, claude-code-ui starts the previous one and says so. To retry, delete versions/<version> in the config folder and restart.
• A source checkout (npm start) does not update itself.
• Turn the check off with --no-update-check. Use a registry mirror with CLAUDE_UI_UPDATE_REGISTRY=https://npm.example.com.
• The check only asks npm for the latest version number. Nothing about you or your sessions is sent.