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

# アップデート計画

> Linkly AI のリリースペース、アップデートチャネル、アップグレード方法

Linkly AI は、デスクトップクライアント、CLI、Skills といった連携するコンポーネントで構成されています。
安定性を保ちながら新機能をいち早くお届けするために、それぞれ異なるアップデート方式を採用しています。本ページでは、リリースペースの目安と、シーンごとに必要な操作を説明します。

## 一、各コンポーネントのアップデート方式

| コンポーネント              | アップデート方式 | ユーザー操作の要否          |
| -------------------- | -------- | ------------------ |
| **デスクトップクライアント**     | 自動更新     | 不要（再起動で反映）         |
| **Linkly AI CLI**    | 手動更新     | 必要（コマンド実行）         |
| **Linkly AI Skills** | 手動更新     | 必要（インストールコマンドを再実行） |

<Note>
  デスクトップクライアントの新バージョンがリリースされる際は、**CLI と Skills
  も同時にアップグレードする必要がある**ことが多いです。各更新履歴の冒頭には 💡
  Tips の形式で同期アップグレードが必要かどうかが示されます。
</Note>

<Tip>
  CLI と Skills の手動アップデートは、必ずしも自分で実行する必要はありません——
  **接続している AI Agent や OpenClaw にアップグレードコマンドを実行してもらう**
  ことができます。例えば Claude、Cursor、OpenClaw などに「Linkly AI の CLI と
  Skills を最新版にアップグレードして」と伝えるだけで OK です。
</Tip>

## 二、デスクトップクライアントのリリースチャネル

デスクトップクライアントは 2 つのアップデートチャネルを提供しています。お好みに合わせて選択してください。

| チャネル             | リリース頻度   | 安定性               | 推奨対象                         |
| ---------------- | -------- | ----------------- | ---------------------------- |
| **正式版 (Stable)** | 週 1 回    | 高い、ベータで十分に検証済み    | ほとんどのユーザー                    |
| **開発版 (Beta)**   | 週 1 ～複数回 | 試験的機能を含み、不安定な場合あり | 新機能を先に試したい、トラブル対応が苦にならないユーザー |

### 正式版

* デフォルトのチャネル。新規インストール時はそのまま正式版が使用されます
* 通常週 1 回リリースされ、開発版で一定期間検証されて安定した機能をマージします
* 安定したペースで、日常的に使用するのに適しています

### 開発版（Beta）

* 週 1 ～複数回リリースされ、最新の試験的機能を含みます
* 機能はまだ磨き上げの段階にあるため、**ある程度の不安定さが想定されます**（偶発的なクラッシュ、UI の細部調整、データ形式の微調整など）
* これらを許容し、問題があればフィードバックしてくださる方にお勧めします

<Tip>
  開発版で見つかった問題は、ぜひ [GitHub
  Issues](https://github.com/LinklyAI/linkly-ai-skills/issues)
  またはコミュニティでお知らせください。皆さんのフィードバックは次の正式版の品質に直接反映されます。
</Tip>

## 三、自動更新の仕組み

デスクトップクライアントはバックグラウンドで自動的にアップデートを確認・ダウンロードします。手動の操作は不要です。

* **確認タイミング**：起動から約 3 秒後に最初の確認、その後 4 時間ごとに再確認
* **ダウンロード動作**：新バージョンを検出するとバックグラウンドで自動ダウンロード
* **反映タイミング**：ダウンロード完了後、**次回アプリ再起動時に**自動でインストール・有効化
* **手動確認**：いつでも **設定 → 情報** から「アップデートを確認」ボタンで即時確認できます

## 四、開発版に参加する

<Steps>
  <Step title="デスクトップクライアントを開く">
    Linkly AI デスクトップアプリを起動します。
  </Step>

  <Step title="設定ページを開く">
    トレイアイコンまたはクライアント右上のメニューから **設定 → 情報**
    を開きます。
  </Step>

  <Step title="ベータプログラムに参加 を有効化">
    「ベータプログラムに参加」スイッチをオンにします。
  </Step>

  <Step title="最新の開発版を取得">
    自動確認を待つ（最長 4
    時間）か、「アップデートを確認」をクリックして最新の開発版をすぐに取得します。ダウンロード完了後、再起動するだけです。
  </Step>
</Steps>

### 開発版から離脱する

**設定 → 情報** で「ベータプログラムに参加」スイッチをオフにするだけで、以降は正式版のみを受信します。

<Note>
  スイッチをオフにしても、現在インストールされている開発版はロールバックされません。次の正式版がリリースされる際に、自動的に正式版で上書き更新されます。
</Note>

## 五、CLI と Skills の手動アップデート

### Linkly AI CLI

CLI は起動時にバックグラウンドで新バージョンを静かに確認し、見つかるとターミナルに通知を表示します。アップグレード時は次のコマンドを実行します：

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

詳細なインストールと使用方法は [Linkly AI CLI](./use-cli) を参照してください。

### Linkly AI Skills

Skills には組み込みのアップグレードコマンドがありません。インストール方式に応じて以下を選択してください：

* **`skills add` でインストール**：インストールコマンドを再実行すると上書き更新されます
  ```bash theme={null}
  npx skills add LinklyAI/linkly-ai-skills
  ```
* **`git clone` でインストール**（Claude Code、Codex CLI など）：skill のディレクトリで実行
  ```bash theme={null}
  git pull
  ```
* **Claude.ai にアップロード**：[GitHub Releases](https://github.com/LinklyAI/linkly-ai-skills/releases) から `linkly-ai.zip` を再ダウンロードし、Settings → Capabilities → Skills でアップロードして上書き
* **ClawHub 経由**：実行
  ```bash theme={null}
  clawhub install linkly-ai
  ```

詳細なインストールと使用方法は [Linkly AI Skills](./use-skills) を参照してください。

## 六、バージョン番号の規約

Linkly AI の各コンポーネントは [セマンティックバージョニング](https://semver.org/lang/ja/)（Semantic Versioning）を採用しています：

* **正式版** は `v0.4.1` のような形式
* **開発版** は `v0.4.2-beta.1`、`v0.4.2-beta.2` のような形式
* デスクトップクライアント、CLI、Skills はそれぞれ独立してバージョン番号を管理しており、通常はクライアントのリリースと同時に対応する CLI / Skills の新バージョンをリリースします

過去のバージョンと各バージョンの具体的な変更内容は [更新履歴](./changelog) を参照してください。