Skip to main content
If you reinstalled Hoard Desktop and your agent still shows the same old version number, the reinstall isn’t the thing that’s supposed to change it — the agent updates itself separately.

​
Why a reinstall doesn’t touch the agent

Hoard Desktop and the agent are two different binaries. Reinstalling the desktop wrapper replaces the desktop app itself, but the agent binary lives in its own location outside the app bundle and isn’t touched by a desktop reinstall. So “I reinstalled but the agent version didn’t move” is expected, not a sign the reinstall failed.

​
How the agent actually updates

The agent checks in with Hoard on every heartbeat and updates itself automatically when a new version is available for your update channel — it doesn’t wait for you to reinstall anything. There are two channels:
  • Stable (default) — only receives versions that have been explicitly promoted to stable.
  • Beta — receives the newest release on either channel, ahead of stable.
You can switch channels from Settings → Account → Updates. The update path only ever installs a newer version than the one already running — it won’t roll your agent back to an older build.

​
Why your version might not be advancing

If your agent version genuinely hasn’t moved in a while, the most common reason is that a newer version exists but hasn’t been promoted to your channel yet — betas are generally held for about a week before being promoted to stable automatically, unless something’s flagged to skip that. This is a release-process gap, not something wrong with your install.

​
What to check

  1. Confirm your update channel in Settings → Account → Updates. If you’re on stable and expecting a beta feature, switch to beta.
  2. Give it a sync cycle or two. The agent checks for updates on its own heartbeat schedule — it doesn’t need you to trigger anything manually.
  3. If the binary is missing entirely (not just old), the agent re-downloads it automatically on its next heartbeat rather than failing silently.
  4. Reinstalling the desktop app won’t fix a stuck agent version — if it’s genuinely stuck, that points at the update channel or release promotion, not your local install.

​
The short version

Reinstalling the desktop app addresses the wrapper around your agent, not the agent itself. If the version number you care about hasn’t moved, look at your update channel and give the agent’s own heartbeat-driven update a chance to run before assuming the install is broken.