/upgrade

sidebar_position: 3

upgrade

skillshare CLI バイナリおよび／または組み込みの skillshare Skill をアップグレードします。

skillshare upgrade              # CLI と Skill の両方をアップグレード
skillshare upgrade --cli        # CLI のみ
skillshare upgrade --skill      # Skill のみ

使うタイミング

• 新しいバージョンの skillshare CLI が利用可能なとき
• 組み込みの skillshare Skill を更新する必要があるとき
• `doctor` が利用可能な更新を報告した後

skillshare upgrade --skill --dry-run
  Skill     v0.21.12 → v0.21.13 · would download

Dry run — nothing was written

実行される処理

flowchart TD
    TITLE["skillshare upgrade"]
    CLI["1. Upgrade CLI binary"]
    SKILL["2. Upgrade built-in skill"]
    TITLE --> CLI --> SKILL

オプション

| フラグ | 説明 | |------|-------------| | `--cli` | CLI のみアップグレード | | `--skill` | Skill のみアップグレード（未インストールの場合はプロンプトを表示） | | `--force, -f` | 確認プロンプトをスキップ | | `--dry-run, -n` | 変更を加えずにプレビュー | | `-h`, `--help` | ヘルプを表示 |

Homebrew ユーザー

Homebrew でインストールした場合、`skillshare upgrade` は自動的に `brew upgrade` に処理を委譲します。

skillshare upgrade
# → brew update && brew upgrade skillshare

Homebrew を直接使うこともできます。

brew upgrade skillshare

Nix ユーザー {#nix-users}

Nix でインストールした場合、Nix store 内のファイルを置き換えると store が壊れるため、`skillshare upgrade` は CLI を更新しません。新しいバージョンがある場合は、代わりに更新方法を表示します。`nix profile add` でインストールした場合は次のコマンドです。

nix profile upgrade skillshare

NixOS、Home Manager、overlay の設定で skillshare を提供している場合は、その設定で skillshare を更新し（flake input なら `nix flake update skillshare`）、リビルドしてください。ダッシュボードの更新ボタンも同じ案内を表示します。

組み込みスキルは引き続き `skillshare upgrade --skill` で更新できます。

例

# 標準的なアップグレード（CLI と Skill の両方）
skillshare upgrade

# アップグレードされる内容をプレビュー
skillshare upgrade --dry-run

# プロンプトなしで強制アップグレード
skillshare upgrade --force

# CLI バイナリのみアップグレード
skillshare upgrade --cli

# skillshare Skill のみアップグレード
skillshare upgrade --skill

アップグレード後

Skill をアップグレードした場合、`skillshare sync` を実行して配布してください。

skillshare upgrade --skill
skillshare sync  # すべての Target に配布

アップグレードされるもの

CLI バイナリ

`skillshare` 実行ファイル自体です。GitHub releases からダウンロードされます。

実行中のバイナリを置き換える前に、リリースの `checksums.txt` と照合してアーカイブを検証します。そのため、破損したり一致しないダウンロードはインストールされるのではなく、アップグレードが中止されます。現在のバイナリはそのまま残り、エラーが不一致を示します。

ターミナルでは、ダウンロード済みの量が表示されるため、回線が遅くてもハングしたようには見えません。下記の Web UI アセットでも同じ表示になります。

Downloading v0.21.4...  3.2 MB / 9.1 MB

インストールスクリプトのデフォルトは `~/.local/bin` になり、通常の更新に `sudo` は不要です。既存のインストール先は変わりません。

バイナリが保護されたディレクトリ（例: `/usr/local/bin`）にある場合、skillshare は `sudo` を使ってバイナリの置き換えだけを行います — 手動でのプレフィックス指定は不要です。組み込み skill、UI アセット、ログはあなたのユーザーとして書き込まれるため、アップグレード全体を `sudo` で実行しないでください。skill ソースに root 所有のファイルが残り、後の `git pull` が `Permission denied` で失敗します。

以前のアップグレードですでにそのようなファイルが残っている場合、組み込み skill の更新は `permission denied` で失敗し、エラーに skill ソースの所有者を自分に戻すコマンドが表示されます。例:

sudo chown -R "$(id -un)" ~/.config/skillshare/skills

パスワードを尋ねるための端末がない場合（Dashboard の **今すぐ更新** ボタン、CI など）、アップグレードは入力を待たずに即座に停止し、代わりにターミナルで `skillshare upgrade` を実行するよう案内します。キャッシュされた `sudo` の認証情報や `NOPASSWD` 設定がある場合は、プロンプトなしでアップグレードが続行されます。

Web UI アセット

アップグレード後、skillshare は新しいバージョンの Web UI フロントエンドアセットを事前にダウンロードします。これらは `~/.cache/skillshare/ui/<version>/` にキャッシュされ、`skillshare ui` を実行したときに提供されます。

事前ダウンロードでは、新しいバージョンとアップグレード前の CLI バージョンのアセットを保持するため、実行中の UI サーバーは引き続きファイルを読み込めます。他のキャッシュ済みバージョンは削除されます。アップグレードの間にアプリまたは UI サーバーを再起動してください。再起動せずに 2 回アップグレードすると、最も古いサーバーのアセットが削除される場合があります。

事前ダウンロードが失敗した場合（ネットワークの問題など）、代わりに次回の `skillshare ui` 起動時にアセットがダウンロードされます。

skillshare Skill

AI CLI に `/skillshare` コマンドを追加する組み込みの `skillshare` Skill です。以下に配置されています。

~/.config/skillshare/skills/skillshare/SKILL.md

関連項目

• [update](/docs/reference/commands/update) — 他の Skill やリポジトリを更新
• [status](/docs/reference/commands/status) — 現在のバージョンを確認
• [doctor](/docs/reference/commands/doctor) — 問題を診断