新しい Minion への乗り換え
以前に npm(@geekbeer/minion、Node.js 版)で用意したミニオンは、同じ機械・同じミニオンのまま 新しい Minion に乗り換えられます。ミニオンの名前・所属するワークスペースとプロジェクトのメンバー・チケットの担当・AI の利用の上限はそのままです。ミニオンのデータは機械の上で移り、Minion Workspace を通りません。
乗り換えは、ミニオンの持ち主が Minion Workspace で承認したときに切り替わります。
| データ | 移り方 |
|---|---|
| メモリー | ミニオンが入っているすべてのワークスペースへ。プロジェクトのメモリーは、そのプロジェクトのワークスペースへ |
| デイリーログ | 日付ごとに、そのワークスペースへ |
| ToDo | 終わってから 30 日を過ぎたものは移しません |
| ルーティン | 名前が新しい決まり(英小文字・数字・-)に合わないときは名前が変わります |
| チャットの履歴 | 読めるように移します。会話の続きからは話しません |
| ファイル | ミニオンの files フォルダ |
| Minion Apps | アプリのデータ。ミニオンの AI が作ったアプリはコードも移します |
| 権限・振り返りの時刻 | 自分で足した拒否のルールと、振り返りの時刻 |
ワークスペースの決まっていないルーティン・ToDo・チャットは、乗り換えるときに選んだワークスペースへ移ります。
移らないもの
Section titled “移らないもの”- シークレット — 値は移しません。乗り換えの報告に名前が出るので、入れ直してください
- 変数 — 新しい Minion にはミニオンの変数がありません。報告に名前と値が出るので、ワークスペースの変数に入れ直してください
- 実行の記録 と、Minion Workspace に無い 手元だけのスキル
- 自分の Claude のサインイン — 以前のミニオンがユーザー
minionで動いていたとき(macOS の案内どおりのとき)は、そのユーザーごと引き継ぐのでそのまま残ります。それ以外は、頭脳 タブからもう一度サインインします - Claude 以外の AI(Gemini・Codex)の設定
移さなかったものは、乗り換えの報告に理由と一緒に出ます。以前のミニオンのデータは、機械の上の控えに 30 日残ります(シークレットの値と API トークンは消します)。
- 乗り換えのあいだ、ミニオンが動かしている仕事は止まります
- 乗り換えを始めるのと承認するのは、ミニオンの持ち主 だけができます。2 段階認証を設定しているときは、最近入力したコードを求められます(既定は 10 分以内。ワークスペースの設定で変えられます)
- 以前のミニオンが別の Minion Workspace(URL が違うもの)につながっているときは乗り換えられません
ミニオンの詳細画面の 概要 タブに 新しい Minion に乗り換える が出ます。機械の種類を選ぶと、手順が出ます。
クラウド VPS
Section titled “クラウド VPS”乗り換えを始める を押します。Minion Workspace が以前のミニオンを Node.js 版の最後の版に更新し、その更新が新しい Minion を入れて引き継ぎます。10 分ほどかかり、承認は要りません。うまくいかなかったときは以前のミニオンのまま動き続け、理由が詳細画面に出ます。同じ VPS のままなので、料金は変わりません。
Windows・macOS
Section titled “Windows・macOS”- Minion をダウンロード から新しい Minion のインストーラーを入れます(Windows・macOS)
- インストーラーが以前のミニオンを見つけると、引き継いでよいかを聞きます。Windows は OK を、macOS は 続ける を押します。インストールに失敗したときは、以前のミニオンが元どおり動き続けます
- Minion のウィンドウに、承認のコードと「引き継ぎとして承認」の文が出ます。リンクを開き、引き継いで承認する を押します
画面の無いインストール(msiexec /qn)では聞けないので、引き継ぐときは TAKEOVER_NODE=1 を付けます。付けなければ、以前のミニオンが入っている PC ではインストールは止まります。
引き継ぎの作業役の Windows・macOS のユーザーは、次のとおりです。
- 以前のミニオンがユーザー
minionで動いていたとき(macOS の案内どおりのとき)— そのユーザーを作業役として引き継ぎます。パスワード・自動ログイン・自分の Claude のサインインはそのまま残ります。管理者のグループに入っているときは、外してからインストールしてください - それ以外(自分のアカウントで動かしていたとき)— 新しく
minionユーザーを作り、filesフォルダをそこへ写します。セットアップの手順どおりに、minionのパスワードを決めてサインインしてください
- Linux を選んで 乗り換えを始める を押すと、コマンドが出ます
- 以前のミニオンの機械で、30 分以内にそのコマンドを実行します(
sudoが要ります)
curl -fsSL https://minionworkspace.com/setup/minion.sh | sudo sh -s -- --take-over-node --enroll-token mwe_…コマンドにはこのミニオンの登録用トークンが入っています。ほかの人に見せないでください。インストールに失敗したときは、以前のミニオンが元どおり動き続けます。
Docker のコンテナ
Section titled “Docker のコンテナ”- Docker のコンテナ を選び、今のコンテナの名前を入れて 乗り換えを始める を押すと、コマンドが出ます
- 以前のコンテナがある機械で、30 分以内にそのコマンドを実行します。以前のコンテナからデータを取り出し(
./minion-takeover)、以前のコンテナを止めて、新しいコンテナを起こします - 乗り換えが済んだら、以前のコンテナと
./minion-takeoverは消してかまいません
乗り換えたあと
Section titled “乗り換えたあと”詳細画面に 乗り換えの報告 が出ます。
- 移したもの・移さなかったもの を確かめます
- 入れ直すシークレット を 環境変数 タブで入れ直します。新しい Minion ではシークレットはワークスペースごとにあり、実行には、そのスキルが宣言したものだけが渡ります
- 変数 をワークスペースの変数に入れ直します
- 頭脳 タブで AI がつながっているか確かめます。ミニオンAI と自分の API キーは、乗り換えのときにつなぎ直します。自分の Claude のプランは、ユーザーを引き継いでいなければサインインし直します
- 機械に残したもの(以前のミニオンが入れた Node.js・Homebrew の道具・TightVNC など)は、ほかで使っていなければ消してかまいません
Minion Apps は、乗り換えのあとに Minion Workspace が入れ直します。
うまくいかないとき
Section titled “うまくいかないとき”承認のページに「持ち主が承認してください」と出る
Section titled “承認のページに「持ち主が承認してください」と出る”引き継ぎの承認は、そのミニオンの持ち主だけができます。ミニオンの持ち主のアカウントで開き直してください。
インストールが途中で失敗する
Section titled “インストールが途中で失敗する”以前のミニオンは元どおり動き続けます。よくある原因は次のとおりです。
- 以前のミニオンが、別の Minion Workspace(URL が違うもの)につながっている
- 引き継ぐユーザー
minionが管理者のグループに入っている - macOS で、以前のミニオンが 2 つ以上のユーザーで入っている(1 つを残して アンインストール します)
理由は、Windows ではインストーラーのメッセージに、macOS では /var/log/install.log の minion の行に出ます。
Linux のコマンドが「古い Minion が入っている」と止まる
Section titled “Linux のコマンドが「古い Minion が入っている」と止まる”--take-over-node の無いコマンドは、以前のミニオンを見つけると止まります。ミニオンの詳細画面の 新しい Minion に乗り換える で出るコマンドを使ってください。
乗り換えずに入れ直す
Section titled “乗り換えずに入れ直す”新しいミニオンとして一から始めたいときは、以前のミニオンをアンインストールしてから(Windows・macOS。Linux は sudo minion-cli uninstall のあと sudo npm uninstall -g @geekbeer/minion)、Minion を入れて新しいミニオンとして承認します。このときは、以前のミニオンのシークレット・変数・メモリー・デイリーログ・ToDo・ルーティン・実行の記録・チャットの履歴・ファイル・Minion Apps のデータは移りません。要るものは、アンインストールの前にノートやドライブに写しておいてください。