Skip to Content
Skip to Content
インストールとログイン

インストールとログイン

CLIをインストールし、ブラウザーでログインしてから、最初のスキル一覧を確認しましょう。以下のコマンドは、ターミナルで1行ずつ実行してください。

事前に準備するもの

  • ログインするアカウントと所属組織が必要です。まだ組織に参加していない場合は、組織管理者に招待を依頼してください。
  • 普段利用しているサービスのURLを確認してください。ブラウザーでログインするときのアドレスです。
  • PCでターミナルを開いてください。macOSではターミナルアプリ、WindowsではPowerShell、Linuxではターミナルを利用できます。

1. Node.jsを準備する

Node.jsは、CLIを実行するために必要なプログラムです。24.18.0以降を使用してください。まず、インストールされているか確認します。

node --version

v24.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. 自動で開いたブラウザーで、普段利用しているアカウントにログインします。
  2. アクセスできる組織が複数ある場合は、利用する組織を選択します。1つだけの場合は自動で選択されます。
  3. ターミナルにログイン完了の案内が表示されたことを確認します。

ブラウザーが開かない場合は、ターミナルに表示されたログイン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 current

auth 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を使用してください。開発・検証用の配布チャンネルに切り替えても、サーバーが提供していない機能は利用できません。

Last updated on