インストールとログイン
CLIをインストールし、ブラウザーでログインしてから、最初のスキル一覧を確認しましょう。以下のコマンドは、ターミナルで1行ずつ実行してください。
事前に準備するもの
- ログインするアカウントと所属組織が必要です。まだ組織に参加していない場合は、組織管理者に招待を依頼してください。
- 普段利用しているサービスのURLを確認してください。ブラウザーでログインするときのアドレスです。
- PCでターミナルを開いてください。macOSではターミナルアプリ、WindowsではPowerShell、Linuxではターミナルを利用できます。
1. Node.jsを準備する
Node.jsは、CLIを実行するために必要なプログラムです。24.18.0以降を使用してください。まず、インストールされているか確認します。
node --versionv24.18.0以降のバージョンが表示されたら、次の手順に進んでください。コマンドが見つからない場合やバージョンが古い場合は、Node.js公式ダウンロードページ から条件に合うバージョンをインストールしてください。インストール後、ターミナルを閉じて開き直し、再度バージョンを確認します。
2. CLIをインストールする
現在のCLIバージョンは2026.6.14です。
Node.jsと一緒にインストールされるnpmを使います。
npm install -g aipctl@latestインストールが終わったら、次のコマンドを実行してください。
aipctl --versionバージョン番号が表示されれば、インストールは完了です。以降はaipctlでコマンドを実行できます。
npmやaipctlが見つからないと表示された場合は、ターミナルを開き直して実行してください。解消しない場合や、インストール時の権限エラーが表示される場合は、トラブルシューティングを確認してください。
3. 接続先を設定してログインする
接続先がhttps://app.querypie.comの場合は、以下をそのまま実行してください。組織で別のURLを利用している場合は、そのURLに置き換えます。
aipctl config set --app-url https://app.querypie.com続いて、ログインコマンドを実行します。
aipctl auth login- 自動で開いたブラウザーで、普段利用しているアカウントにログインします。
- アクセスできる組織が複数ある場合は、利用する組織を選択します。1つだけの場合は自動で選択されます。
- ターミナルにログイン完了の案内が表示されたことを確認します。
ブラウザーが開かない場合は、ターミナルに表示されたログインURLをコピーし、同じPCのブラウザーで開いてください。5分以内に完了できなかった場合は、aipctl auth loginを再度実行します。
4. 最初のコマンドを実行する
ログイン時に選択した組織のスキル一覧を確認します。以下は一覧を取得するコマンドです。
aipctl skill listスキル一覧が表示されれば、最初の確認は完了です。登録済みのスキルがない組織では、一覧が空になる場合があります。エラーなく処理が終われば、正常に接続できています。
続いて、スキル管理でダウンロードや登録の方法を確認するか、エージェント管理に進んでください。各コマンドはコマンドリファレンスで確認できます。
別の組織に切り替える
複数の組織に所属している場合は、ブラウザーで利用する組織を選び直せます。
aipctl org selectターミナルで選択する場合は、先に組織一覧を確認します。
aipctl org list一覧のslugをコピーし、ORG_SLUGの代わりに入力してください。slugは、組織名やIDとは異なる場合があります。
aipctl org use ORG_SLUG別の組織で1回だけコマンドを実行する場合は、--orgを付けます。保存済みの既定の組織は変わりません。
aipctl skill list --org OTHER_ORG_SLUGログイン情報の更新とログアウト
ログイン情報は必要に応じて自動更新されます。手動で更新する必要がある場合は、次のコマンドを使用してください。
aipctl auth refreshこのPCからログアウトする場合は、次のコマンドを実行します。
aipctl auth logoutログアウトすると、このPCに保存されたログイン情報が削除されます。別のアカウントを使う場合は、ログアウト後にaipctl auth loginを実行してください。サーバーに送信済みの処理は、ログアウトしても取り消されません。
接続情報を確認する
設定済みの接続先URLは、次のコマンドで確認できます。
aipctl config statusログイン状態、アカウント、選択中の組織は、それぞれ次のコマンドで確認できます。
aipctl auth status
aipctl auth whoami
aipctl org currentauth statusとorg currentは、PCに保存された状態を表示します。現在のアカウント情報をサーバーから取得するには、auth whoamiを使用してください。
aipctl config set --app-urlで接続先URLを変更すると、保存済みのログイン情報と選択中の組織が削除されます。変更後は再度ログインしてください。同じPCでは、異なるバージョンのCLIもローカル設定を共有します。
CLIを更新する
npm install -g aipctl@latest
aipctl --versionスクリプトで特定のバージョンが必要な場合は、VERSIONを実際のバージョンに置き換えて固定できます。
npx --yes --package=aipctl@VERSION -- aipctl --version通常はlatestを使用してください。開発・検証用の配布チャンネルに切り替えても、サーバーが提供していない機能は利用できません。