AgentFixboard

macOS Desktop update fails with 'Another Hermes update is already running'

On macOS, every update started from the Desktop app's Update button fails with exit code 2, and the app keeps retrying every few minutes.

From GitHub

NousResearch/hermes-agent

Difficulty
Easy
Time
~5 min
Steps
2
Fixed in
v0.21.7
Last checked

Verified fix: PR #134551 merged on . Fixed in v0.21.7 (first stable release containing the merge commit). Last checked .

Symptom

On macOS, every update started from the Desktop app's Update button fails with exit code 2, and the app keeps retrying every few minutes.

Evidence what you'll see

  • Error: Another Hermes update is already running (started a few seconds ago, process <pid>)
  • The PID in the error belongs to the helper the same update just started
  • Running hermes update from a terminal with the Desktop app closed works

Cause

The update lock recorded the hand-off helper as its owner, but hermes update didn't recognize that helper as part of its own update, so it refused the lock.

Fix steps

0 of 2 done

Your check marks stay in this browser only.

Verify the fix worked

  • Click Update in the Desktop app and confirm the update finishes without the lock error.

Sources and credit

Summarized in our own words from these public reports. Credit goes to their authors.

Provided as is, without warranty. Try changes in a non-production environment and back up first. Security-related steps: verify against the official docs. Terms · Request removal or attribution change

Hit an error we don't cover? Submit it