Skip to main content
Linkly AI is made up of several components that work together: the desktop client, the CLI, and Skills. To balance stability with delivering new features quickly, each component uses a different update mechanism. This page describes the release cadence you should expect and what you need to do in different scenarios.

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.
You don’t have to upgrade the CLI and Skills by hand—you can simply ask a connected AI Agent or OpenClaw to run the upgrade for you. For example, tell Claude, Cursor, or OpenClaw: “Please upgrade Linkly AI CLI and Skills to the latest version.”

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
Issues found in Beta are very welcome on GitHub Issues or in the community—your feedback directly shapes the next stable release.

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
If auto-update is off, or your CLI was installed another way, update manually as described below.

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:
For installation and usage details, see Linkly AI CLI.

Linkly AI Skills

If you have the CLI, it can check and upgrade the skill for you:
When an update is available, CLI tool output carries a one-line notice saying so; it is informational and safe to ignore. Set 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.zip from GitHub Releases and upload it under Settings → Capabilities → Skills to overwrite
  • Installed via ClawHub: run
For installation and usage details, see Linkly AI Skills.

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
For the full version history and per-version changes, see the Changelog.