メインコンテンツまでスキップ

@aquaringlab/aidk への移行ガイド

パッケージ名が @caeruxlab/aidk から @aquaringlab/aidk に変更され、パッケージレジストリも GitLab から GitHub Packages へ移行されたため、現在お使いのすべてのユーザーは、引き続き AIDK ツールを使用・更新するために以下の移行手順を実行する必要があります。

移行ステップ​

ステップ 1: 旧パッケージ @caeruxlab/aidk のアンインストール​

グローバルにインストールされている古いバージョンをアンインストールするために、以下のコマンドを実行します：

npm uninstall -g @caeruxlab/aidk

ローカル開発で以前に npm link を使用していた場合は、リンクを解除します：

npm unlink -g @caeruxlab/aidk

ステップ 2: 新しい GitHub 個人アクセストークン (PAT) の生成​

@aquaringlab/aidk は GitHub Packages 上でプライベートパッケージとして公開されているため、パッケージの読み取り権限を持つ個人アクセストークンが必要です：

  1. github.com/settings/tokens → Generate new token (Classic) に移動します。
  2. 分かりやすい名前を入力します（例: AIDK-Read-Token）。
  3. read:packages スコープを選択します。
  4. Generate token をクリックし、生成されたトークンをコピーします。

ステップ 3: グローバル .npmrc の更新​

グローバルの npm 設定ファイル (~/.npmrc) を開き、以下を行います：

  1. 古い GitLab 関連の設定を削除します（存在する場合）： 
    # 以下の行を削除します（存在する場合）
    @caeruxlab:registry=https://git.caerux.com/api/v4/...
    //git.caerux.com/api/v4/...:_authToken=...
  2. 新しい GitHub Packages 設定を追加し、YOUR_GITHUB_PAT をステップ 2 で生成したトークンに置き換えます： 
    @aquaringlab:registry=https://npm.pkg.github.com
    //npm.pkg.github.com/:_authToken=YOUR_GITHUB_PAT

ステップ 4: 新しい @aquaringlab/aidk パッケージのインストール​

.npmrc を保存した後、以下のコマンドを実行して最新バージョンの AIDK CLI をグローバルにインストールします：

npm install -g @aquaringlab/aidk

ステップ 5: インストールの確認と動作検証​

以下のコマンドを実行して、インストールが正常に行われたことを確認します：

aidk --version

今後は、すべてのプロジェクトで @aquaringlab スコープの下で GitHub Packages を介して管理される CLI ツールを使用することになります。