ratchet docs
Docs / Get started / Updating

Updating

ratchet checks npm once an hour and shows a banner when a new version is out.

127.0.0.1:4700
The update banner at the top of the page, with What's new and Update now.
The update banner at the top of the page, with What's new and Update now.
  1. Press What's new to read the changes for that version.
  2. Press Update now. If agents are running, ratchet asks first, because updating restarts it and stops them. Pick Update when they finish, Update now or Later.
  3. ratchet shows Updating… ratchet will restart and comes back on the same address.
On the phone

The phone shows What's new only. Update from ratchet on your PC.

By hand

npm install -g @ratchet-ai/ratchet@latest
127.0.0.1:4700
What's new: the changes in the new version, before you update.
What's new: the changes in the new version, before you update.

On a Mac install that needed sudo, add sudo in front. One-click update only works for a global npm install. Other copies say Updates are off for this copy of ratchet.

Screenshots use example data. Written for ratchet 0.2.1.

ratchet is an independent project by Shervin Davarifard. Questions or problems: [email protected].© 2026 Shervin Davarifard · FSL-1.1-MIT licence