1. How each component updates
When the desktop client publishes a new version, the CLI and Skills usually need to be upgraded together to fully use the new features. Each changelog starts with a 💡 Tips block reminding you whether a sync upgrade is needed.
2. Desktop client release channels
The desktop client provides two update channels. Pick the one that fits your preference.Stable
- The default channel; new installs use it out of the box
- Released roughly every one to two weeks, rolling up features that have been validated in Beta
- A steady cadence well suited for everyday use where stability matters
Beta (Dev build)
- Released one or more times a week, containing the latest experimental features
- Because features are still being polished, expect some rough edges (occasional crashes, UI tweaks, minor data-format changes, etc.)
- Recommended only if you accept these tradeoffs and are willing to report problems
3. How auto-update works
The desktop client checks for and downloads updates in the background; once the download finishes, you decide when to restart and install.- When it checks: about 3 seconds after launch, then every 4 hours
- Download behavior: when a new version is found, it downloads in the background
- When it installs: after the download finishes, an update button appears at the bottom of the main window’s left sidebar; click it, then click Restart Now to install and activate the new version. You can also click Restart to Update under Settings → About, or Update to vX.Y.Z in the tray menu. Simply quitting the app does not install the update — after the next launch you still need to restart through one of these entry points to install it
- Manual check: you can also go to Settings → About and click “Check for Updates” to trigger a check immediately
4. Joining the Beta channel
1
Open the desktop client
Launch the Linkly AI desktop app.
2
Open Settings
Right-click the tray icon and click About in the menu; or click the account icon in the bottom-left corner of the main window, click Settings in the menu, and switch to the About tab.
3
Turn on Join Beta Program
Toggle on “Join Beta Program”.
4
Get the latest Beta build
Wait for the next auto-check (up to 4 hours), or click “Check for Updates” to fetch the latest Beta immediately. Once the download completes, click “Restart to Update”.
Leaving the Beta channel
Just turn off “Join Beta Program” under Settings → About. From then on you’ll only receive Stable updates.Turning off the toggle does not roll back the Beta build you currently have installed. The next Stable release will overwrite it as a regular update.
5. Updating the CLI and Skills
Automatic updates from the desktop app
Click the Agent icon at the bottom of the main window’s left sidebar to open the Agent usage page, and turn on Auto-update CLI and Skills in the Advanced section. Once it’s on, the desktop app checks about 5 minutes after launch and then once a day, updating in the background whenever a new version is out. The Connect an agent screen of the first-run wizard has the same toggle, on by default.- It only updates a CLI and Skills that are already installed; it never installs them for you
- For the CLI, it only updates the copy in
~/.linkly/bin(where the desktop app installs it). If you installed the CLI with Homebrew, cargo, or another method, update it yourself with that tool - Don’t want to wait for the automatic check? When the CLI or Skills row in the same section shows vX.Y.Z available, just click Update
Linkly AI CLI
The CLI silently checks for new versions on each launch and prints a notice in your terminal when one is available. To upgrade:Linkly AI Skills
If you have the CLI, it can check and upgrade the skill for you:LINKLY_NO_SKILLS_HINT=1 to turn it off. update respects how each location was installed — a git checkout is reported rather than overwritten.
Otherwise choose the method that matches how you installed it:
- Installed via
skills add: re-run the install command to overwrite - Installed via
git clone(Claude Code, Codex CLI, etc.): inside the skill directory run - Uploaded on Claude.ai: re-download
linkly-skills-latest.zipfrom GitHub Releases and upload it under Settings → Capabilities → Skills to overwrite - Installed via ClawHub: run
6. Versioning
All Linkly AI components follow Semantic Versioning:- Stable versions look like
v1.1.0 - Beta versions look like
v1.2.0-beta.1,v1.2.0-beta.2, … - The desktop client, CLI, and Skills each maintain their own version numbers; new CLI / Skills versions are typically released alongside a new desktop release

