AI Platform CLI
AI Platform CLI lets you view and manage skills, agents, and automations by entering commands in a terminal. Sign in with the account you use in your browser, then run commands using aipctl.
Use it to download skill files to your PC, change agent settings, or put recurring queries into scripts. You can also connect a PC tunnel.
Get started
If this is your first time, follow Installation and sign-in. These steps take you through your first skill list query.
- Install the CLI — Set up Node.js and install the CLI.
- Sign in — Set the service URL and sign in through your browser.
- Run your first command — List the skills in the organization you selected when signing in.
Once you have installed the CLI and signed in, find your task below. To connect your PC, go to Connect a PC tunnel.
Find available commands
Use --help or -h to see the commands available to you.
aipctl --helpAdd --help after a command or group to see its subcommands and options.
# View skill commands
aipctl skill --help
# View inputs and options for downloading a skill
aipctl skill download --helpSee the Command reference for input formats and details.
What you can do with the CLI
| Your task | Where to start |
|---|---|
| Find, download, or upload skills | Lists, details, library, uploads, and downloads |
| Import and update organization skills from GitHub | Import from GitHub and apply changes |
| View, create, and edit agent settings | View, create, and enable agents |
| Manage automation settings and execution history | View, create, update, and enable automations |
| Check files, conversations, integrations, and models | Resource queries and folder management |
| Manage organizations and check usage | Organizations and usage |
| Connect your PC | Connect a PC tunnel |
| Use JSON lists in other tasks | Scripts and list queries |
Before you begin
-
Commands use your signed-in account and selected organization. You can access data and perform tasks within the permissions granted to your account. If you belong to several organizations, check that you have selected the right one. Managing shared organization skills or agents requires a role such as AI Operator that permits the task. If you receive a permission error, contact your organization administrator.
-
Choose the command for your task. For example,
aipctl model listshows available models, andaipctl chat listshows your conversations. These commands do not run a model or send a new message. Use the feature guides or Command reference to find the task you need. -
Available features can vary with your installed version and your organization’s service environment. If you cannot find a command from this guide, check your version with
aipctl --versionand the available commands withaipctl --help. If a command exists but execution is rejected, read the error details. Limitations and troubleshooting explains what to check for each situation.
Read command examples
aipctl skill get SKILL_IDReplace uppercase placeholders such as SKILL_ID with your own values. In this example, use an ID from the skill list. Put names or sentences containing spaces in quotation marks.
Copy a command from a code block, paste it into your terminal, and press Enter. When a block contains several commands, run one line at a time and check the result before continuing.