Skip to Content
Skip to Content
Installation and sign-in

Installation and sign-in

Install the CLI, sign in through your browser, and view your first skill list. Run the commands below one line at a time in your terminal.

Before you start

  • You need an account and organization membership. If you have not joined an organization, ask its administrator for an invitation.
  • Check your service URL: the address you normally use to sign in through your browser.
  • Open a terminal on your PC. Use Terminal on macOS, PowerShell on Windows, or a terminal on Linux.

1. Set up Node.js

Node.js is required to run the CLI. Use version 24.18.0 or later. First, check whether it is installed.

node --version

If the version is v24.18.0 or later, continue to the next step. If the command is not found or the version is older, install a suitable version from the official Node.js download page . After installation, close and reopen your terminal, then check the version again.

2. Install the CLI

The current CLI version is 2026.6.14.

Install the CLI with npm, which is included with Node.js.

npm install -g aipctl@latest

When installation finishes, run:

aipctl --version

A version number confirms that installation is complete. You can now run commands with aipctl.

If npm or aipctl is not found, reopen your terminal and try again. If the problem continues or you receive an installation permission error, see Troubleshooting.

3. Set the service URL and sign in

If your service URL is https://app.querypie.com, run the following command as shown. If your organization uses a different URL, replace it with that address.

aipctl config set --app-url https://app.querypie.com

Now run the sign-in command.

aipctl auth login
  1. Sign in with your usual account in the browser that opens automatically.
  2. If you can access multiple organizations, select one. A single available organization is selected automatically.
  3. Check that your terminal confirms sign-in is complete.

If the browser does not open, copy the sign-in URL from your terminal and open it in a browser on the same PC. If you do not finish within five minutes, run aipctl auth login again.

4. Run your first command

List the skills in the organization selected during sign-in. This command queries the list.

aipctl skill list

When the list appears, your first query is complete. An organization with no registered skills may return an empty list. If the query finishes without an error, the connection is working.

Continue to Manage skills for downloads and uploads, or Manage agents. All documented commands are in the Command reference.

Switch organizations

If you belong to several organizations, you can select another one in your browser.

aipctl org select

To select one in the terminal, first list your organizations.

aipctl org list

Copy the slug from the list and replace ORG_SLUG with it. A slug can differ from an organization’s name or ID.

aipctl org use ORG_SLUG

For a single command in another organization, add --org. Your saved default organization does not change.

aipctl skill list --org OTHER_ORG_SLUG

Refresh sign-in and sign out

Sign-in credentials refresh automatically when needed. To refresh them manually, run:

aipctl auth refresh

To sign out on this PC, run:

aipctl auth logout

Signing out removes the credentials saved on this PC. To use another account, sign out and run aipctl auth login again. Signing out does not cancel tasks already sent to the server.

Check connection details

Check the configured service URL with:

aipctl config status

These commands show your saved sign-in status, current account, and selected organization, respectively.

aipctl auth status aipctl auth whoami aipctl org current

auth status and org current show state saved on your PC. Use auth whoami to retrieve current account information from the server.

Changing the service URL with aipctl config set --app-url clears saved sign-in credentials and the selected organization. Sign in again after changing the URL. Different CLI versions on the same PC share local settings.

Update the CLI

npm install -g aipctl@latest aipctl --version

For a script that requires a specific version, replace VERSION with the version to pin.

npx --yes --package=aipctl@VERSION -- aipctl --version

Use latest for general use. Development and testing release channels do not unlock features that the server does not provide.

Last updated on