CLI のインストール、ログイン、検証
CLI は、Node.js 22 以上を導入した macOS、Windows、Linux に対応しています。エージェントがコマンドを実行するマシンとユーザー環境にインストールしてください。ターミナルを使う場合は、手動の手順に従えます。エージェントに EvoLink のインストールを依頼する
次のプロンプト全体を、エージェントのチャット入力欄に貼り付けてください。公式サイトのプロンプトと同じ内容です。ブラウザでのログインと権限の承認は、ご自身で完了してください。bash のブロックはターミナルで、ステップごとに順に実行します。両方のインストール方法を行う必要はありません。
手動インストール：5つのステップ
1
Node.js と実行環境を確認する
エージェントを実行するマシンで、エージェントを実行するのと同じユーザーとしてターミナルを開きます。macOS ではターミナル、Windows では PowerShell またはコマンドプロンプト、あるいは Cursor の統合ターミナルを使います。成功の目安：どちらのコマンドもバージョンを表示し、Node.js が 22 以降であること。インストールされていない場合やバージョンが古い場合は、Node.js から適切なバージョンをインストールし、ターミナルを開き直して、もう一度確認します。WSL、SSH ホスト、コンテナ、お使いのデスクトップは、それぞれ別の環境です。エージェントがコマンドを実行する環境にインストールしてください。
2
CLI をインストールして確認する
evolink --version で CLI のバージョンが表示されること。-g は、現在の Node/npm のグローバルディレクトリにコマンドをインストールします。MCP やプラグインのリポジトリをクローンする必要はありません。先に進む前に、インストールの問題を解決してください。3
EvoLink にログインする
- コマンドは実行したままにします。ブラウザが開くか、今回の試行用のログインリンクが表示されます。
- EvoLink にログインし、アカウント、クライアント、要求されている権限を確認して、承認します。
- 元のターミナルに戻り、完了を待ってから、次を実行します：
authenticated: true。CLI は、オペレーティングシステムの安全な認証情報ストアを使います。API Key を作成したり貼り付けたりする必要はありません。ブラウザのコールバックだけでは、ターミナル側のログインは完了しません。残高照会による接続確認は、最後のステップで行います。ブラウザ、タイムアウト、Linux の認証情報ストアに関するエラーについては、ログインのトラブルシューティングを参照してください。4
スキルをインストールし、エージェントが検出できることを確認する
--agent を付けない場合、対応しているすべてのスキルディレクトリがインストール先になります。それらのエージェント自体がインストールされるわけではありません。特定のホストだけを対象にするには、下記の一覧にある agent の値を指定します。成功の目安：current: true。エージェントのチャットで、次を送信します：assistant_discovery: not_checked の場合は、ホスト側での確認が必要です。必要に応じて、スキルを再読み込みするか、新しい会話を開いてください。スキルの検出を参照してください。5
無料で検証し、準備ができたことを確認する
ok、connection_verified、model_discovery_verified を true と報告し、エージェントがスキルを読んだことを確認すること。残高がゼロでも接続は確認できますが、生成には十分な残高が必要です。これらのステップでは、有料のメディアタスクは作成されません。すべて完了すれば、アシスタントは準備ができたと伝えてかまいません。failed になったチェックがあれば、先に進む前に解決してください。接続テストのために画像を生成しないでください。単一のエージェント向けにスキルをインストールする
公式サイトで案内しているevolink skills install は、対応しているすべてのディレクトリを対象にします。単一のホストだけを対象にする場合は、下記の AGENT_NAME を次の表の値に置き換えてください：
CLI とスキルを更新する
current: true を確認し、エージェントにスキルを読み直してもらいます。ローカルでの編集は保持されます。--replace-modified は、編集内容を置き換えると決めた場合にだけ使ってください。以前の内容は ~/.evolink-media/skill-backups/ にバックアップされます。新規のインストールには、古い @evolinkai/media-cli / evolink-media を使わないでください。
新しいバージョンがあることを知る方法
CLI 0.10.0 以降では、CLI が自分で npm の最新リリースを確認します：evolink setup、doctor、auth loginは毎回確認を行い、update_available、latest_version、アップグレード用のコマンドを含むupdateを報告します。利用できるアップデートがあっても、それは通知にすぎず、コマンドが失敗することはありません。- オフラインで動作する
auth statusを除くそのほかのコマンドは、オンラインでの確認を多くても1日1回だけ行います。新しいリリースがある場合は、コマンド自体の出力のあとに、stderr へ1行を出力します。同じリリースについての出力は、多くても1日1回です。--jsonの stdout と終了コードは変わりません。 - 確認の際は、アカウント情報を含まないリクエストを1件、公開の npm レジストリ（registry.npmjs.org）に送信します。待機時間は最大3秒で、レジストリに到達できない場合は何も表示しません。
- 確認をオフにするには、
EVOLINK_CLI_UPDATE_CHECK=0を設定します。NO_UPDATE_NOTIFIERに何らかの値が設定されている場合や、CI 環境でも、確認はオフになります。
evolink --version と npm view @evolinkai/cli version の結果を比べるか、CLI の GitHub Releases を開き、Watch → Custom → Releases を選んで購読してください。
ブラウザでの承認が、サイトに戻らずに、二か国語表示の 127.0.0.1 のページで終わる場合は、インストールされている CLI が 0.9.1 より古いバージョンです。先に進む前にアップグレードしてください。
ログイン状態の確認とログアウト
現在のセッションを確認します：Linux と SSH：ブラウザが別のマシンにある場合
Linux でログイン状態を保持するには、現在のユーザーセッションで D-Bus とロック解除済みの Secret Service が必要です。まずこれを確認してください。これがない場合は、credential_store_unavailable になるのが想定どおりの動作です。root 権限はその代わりになりません。安全な認証情報ストアを設定するか、それを備えた環境でローカルに CLI を実行してください。
1
リモートホストでログインを開始する
--no-browser はブラウザの起動を抑止しますが、コールバックは引き続き待ちます。これはデバイスコードによるログインではありません。指定できる範囲は 30–900秒で、デフォルトは180秒です。2
ローカルのターミナルからコールバックポートを転送する
今回の試行の 転送用のターミナルは実行したままにします。プロンプトが表示されず、何も動いていないように見えるのは正常です。ポートが競合した場合は、認証リンクのポートを書き換えずに解決してください。
redirect_uri から、実際のポートを確認します。両方の CALLBACK_PORT と、USER および HOST を置き換えてください。http://127.0.0.1:54321/callback の場合は、両方の位置に 54321 を指定します。認証リンクの全体を公開しないでください。3
このリンクを開き、リモート側で検証する
最初のステップのリンクをローカルのブラウザで開き、ログインして承認したら、リモート側のコマンドが終了するのを待ちます。その同じリモートのユーザー環境で、次を実行します：成功したら、この転送セッションを停止します。タイムアウトした場合は、新しいログインを開始し、その実際のポートを転送してください。古いリンクは再利用できません。ネイティブ MCP のコールバックはホスト側のもので、EvoLink CLI のフラグは使いません。