> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Release Plan

> Linkly AI's release cadence, update channels, and upgrade methods

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

| Component            | Update method | Requires user action             |
| -------------------- | ------------- | -------------------------------- |
| **Desktop client**   | Auto-update   | No (takes effect after restart)  |
| **Linkly AI CLI**    | Manual        | Yes (run a command)              |
| **Linkly AI Skills** | Manual        | Yes (re-run the install command) |

<Note>
  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.
</Note>

<Tip>
  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."
</Tip>

## 2. Desktop client release channels

The desktop client provides two update channels. Pick the one that fits your preference.

| Channel              | Release cadence             | Stability                                       | Recommended for                                                         |
| -------------------- | --------------------------- | ----------------------------------------------- | ----------------------------------------------------------------------- |
| **Stable**           | Once a week                 | High, fully validated through Beta              | Most users                                                              |
| **Beta (Dev build)** | One to several times a week | Includes experimental features, may be unstable | Early adopters who are comfortable troubleshooting and reporting issues |

### Stable

* The default channel; new installs use it out of the box
* Released roughly once a week, 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

<Tip>
  Issues found in Beta are very welcome on [GitHub
  Issues](https://github.com/LinklyAI/linkly-ai-skills/issues) or in the
  community—your feedback directly shapes the next stable release.
</Tip>

## 3. How auto-update works

The desktop client checks for and downloads updates in the background. You don't have to do anything.

* **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 takes effect**: after download, the new version installs and activates **the next time you restart the app**
* **Manual check**: you can also go to **Settings → About** and click "Check for Updates" to trigger a check immediately

## 4. Joining the Beta channel

<Steps>
  <Step title="Open the desktop client">Launch the Linkly AI desktop app.</Step>

  <Step title="Open Settings">
    Click the tray icon or the menu in the top-right of the client, then go to
    **Settings → About**.
  </Step>

  <Step title="Turn on Join Beta Program">Toggle on "Join Beta Program".</Step>

  <Step title="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. Restart after the download completes.
  </Step>
</Steps>

### Leaving the Beta channel

Just turn off "Join Beta Program" under **Settings → About**. From then on you'll only receive Stable updates.

<Note>
  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.
</Note>

## 5. Manually updating the CLI and Skills

### 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:

```bash theme={null}
linkly self-update
```

For installation and usage details, see [Linkly AI CLI](./use-cli).

### Linkly AI Skills

Skills doesn't ship with a built-in upgrade command. Choose the method that matches how you installed it:

* **Installed via `skills add`**: re-run the install command to overwrite
  ```bash theme={null}
  npx skills add LinklyAI/linkly-ai-skills
  ```
* **Installed via `git clone`** (Claude Code, Codex CLI, etc.): inside the skill directory run
  ```bash theme={null}
  git pull
  ```
* **Uploaded on Claude.ai**: re-download `linkly-ai.zip` from [GitHub Releases](https://github.com/LinklyAI/linkly-ai-skills/releases) and upload it under Settings → Capabilities → Skills to overwrite
* **Installed via ClawHub**: run
  ```bash theme={null}
  clawhub install linkly-ai
  ```

For installation and usage details, see [Linkly AI Skills](./use-skills).

## 6. Versioning

All Linkly AI components follow [Semantic Versioning](https://semver.org/):

* **Stable** versions look like `v0.4.1`
* **Beta** versions look like `v0.4.2-beta.1`, `v0.4.2-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](./changelog).