Command reference
Find commands by task, along with required inputs and key options.
General conventions
- Organization commands use the selected organization. Add
--org ORG_SLUGto specify one for a single request. Sign-in, local configuration, and PC tunnel connections use their own inputs. - Get IDs from list results. Names, organization slugs, and resource IDs are not interchangeable.
- JSON and pagination options are available only on supported commands. For options beyond those listed here, check the command’s
--help. --forceconfirms deletion, removal, or leaving an organization. It does not bypass permissions or force a failed operation. You can also use-f.adminis the CLI management group. Permissions depend on the resource and operation.- Account permissions and server availability still apply to commands shown in help. Switching to a development release does not remove these restrictions.
Top-level groups
| Group | Purpose |
|---|---|
auth, config | Sign-in and connection settings |
org | Organization selection and information |
skill, agent, automation | Resource queries and management |
chat, drive, integration | Conversation, file, and integration queries |
model | Model list |
admin | Management groups: org, agent, skill, integration, usage, audit, tunnel |
tunnel | PC tunnel connection |
admin skill github contains inspect, import, sync, and credentials. Under credentials, use set or clear. The executable command under tunnel is link.
Sign-in and connection settings
Installation, sign-in, refresh, and environment switching
| Command | Inputs and key options | Behavior and notes |
|---|---|---|
aipctl auth login | None | Sign in through a browser and select an organization. Complete the flow on the same PC. |
aipctl auth logout | None | Removes local credentials. Does not cancel submitted tasks. |
aipctl auth status | None | Shows saved sign-in state and expiration. Does not test server connectivity. |
aipctl auth whoami | None | Retrieves the current user from the server. |
aipctl auth refresh | None | Refreshes the current authentication token. Sign in again if the session cannot be refreshed. |
aipctl config set | --app-url APP_URL | Saves the service URL. A changed URL clears credentials and organization selection. |
aipctl config status | None | Shows the service URL and settings saved on the PC. |
Organizations
Select an organization · Organization guide
| Command | Inputs and key options | Behavior and notes |
|---|---|---|
aipctl org list | [--json] | Lists accessible organizations and slugs. |
aipctl org current | None | Shows the saved default organization. |
aipctl org use | ORG_SLUG | Saves the default organization for subsequent commands. |
aipctl org select | None | Selects the default organization in a browser. |
aipctl org members | [--org ORG_SLUG] | Lists members. Requires AI Operator permissions. |
aipctl org capabilities | [--org ORG_SLUG] | Lists available organization features. |
aipctl org settings | None | Shows current user settings. Does not edit organization settings. |
aipctl org exit | --force [--org ORG_SLUG] | Leaves the specified organization. Check the organization first. |
Skills
View, clone, transfer, and delete skills
| Command | Inputs and key options | Behavior and notes |
|---|---|---|
aipctl skill list | [--search TEXT] [--json] | Lists accessible skills. |
aipctl skill get | SKILL_ID [--json] | Shows details and information for up to 10 files. |
aipctl skill upload | FILE [--overwrite] | Uploads .zip or .skill files. Use --overwrite only to replace the same name. |
aipctl skill download | SKILL_ID [-o FILE] | Saves a downloadable organization skill. Overwrites the destination file. |
aipctl skill delete | SKILL_ID --force | Deletes a skill after you verify the target. |
aipctl skill library | [--search TEXT] | Lists shared library skills. Does not support --json. |
aipctl skill clone | SKILL_ID [SKILL_ID ...] | Clones up to five library skills. Check each result. |
aipctl skill built-in | [--search TEXT] | Lists built-in skills. Requires AI Operator permissions. |
aipctl skill clone-built-in | SKILL_ID [SKILL_ID ...] | Clones up to five built-in skills. Requires AI Operator permissions. |
Agents
View agents and change enabled state
| Command | Inputs and key options | Behavior and notes |
|---|---|---|
aipctl agent list | [--json] | Lists installed agents. |
aipctl agent get | AGENT_ID [--json] | Shows name, description, and required integrations. |
aipctl agent enable | AGENT_ID | Enables an agent subject to policy and permissions. |
aipctl agent disable | AGENT_ID | Disables an agent. |
aipctl agent chat | --agentId AGENT_ID -m MESSAGE [--json] or --conversation-id ID -m MESSAGE [--json] | Starts or continues a conversation. Also accepts standard input. If the outcome is unclear, check conversation history before resending. |
Automations
Creation, updates, and trigger examples
| Command | Inputs and key options | Behavior and notes |
|---|---|---|
aipctl automation list | [--name TEXT] [--json] | Filters by name or returns JSON. Lists the first 50 items with no next-page option. |
aipctl automation get | AUTOMATION_ID [--json] | Shows saved settings. Secrets may not be fully displayed. |
aipctl automation triggers | webhook --service-type SERVICE_TYPE | Retrieves webhook setup information. External mail and storage setup queries are restricted. |
aipctl automation history | AUTOMATION_ID [--page N] | Retrieves execution history by page. |
aipctl automation create | JSON_FILE | Creates schedule, webhook, or My Drive automations. Match the trigger type in the creation JSON. |
aipctl automation update | AUTOMATION_ID JSON_FILE | Updates supported automations. Include fields you want to retain in the input file. |
aipctl automation delete | AUTOMATION_ID --force | Deletes an automation. |
aipctl automation enable | AUTOMATION_ID | Enables an automation. Its conditions may cause agent execution. |
aipctl automation disable | AUTOMATION_ID | Disables an automation. Does not confirm cancellation of running tasks. |
aipctl automation run | AUTOMATION_ID | Requests immediate execution. Check history for completion. |
aipctl automation cancel | AUTOMATION_ID SEQ | Requests cancellation by history sequence number. Check eligibility and final result. |
aipctl automation webhook-regen | AUTOMATION_ID [--show-sensitive] | Regenerates the webhook URL. Output is masked by default; also update the sending service’s URL configuration. |
--account-id and --folder-id in automation triggers help are for external services. Accepting these options does not mean the current server supports those services. Check trigger setup information and supported services.
Conversations and My Drive
File and conversation queries and limitations
| Command | Inputs and key options | Behavior and notes |
|---|---|---|
aipctl chat list | [--json] | Lists your conversations. |
aipctl chat get | CONVERSATION_ID | Shows your conversation details. No --json. Does not reproduce all web attachments, tags, or archived state. |
aipctl chat messages | CONVERSATION_ID | Shows masked text, up to 500 characters per message. No --json. |
aipctl drive list | None | Lists My Drive items. No --json. |
aipctl drive mkdir | NAME | Creates a root folder. No parent-folder option. |
aipctl drive rename | ENTRY_ID NEW_NAME | Renames a file or folder. |
aipctl drive delete | ENTRY_ID [ENTRY_ID ...] --force | Deletes one or more files or folders. Folder deletion affects descendants. |
aipctl drive usage | None | Shows storage usage. |
aipctl drive upload | FILE | Uploads a local file to the root. Check the returned ID and list. |
aipctl drive download | ENTRY_ID --output FILE | Requires a destination. Also accepts -o; overwrites existing destination files. |
Integrations and models
Query integration, tool, and model information
| Command | Inputs and key options | Behavior and notes |
|---|---|---|
aipctl integration list | None | Lists accessible integrations and policy status. |
aipctl integration test | INTEGRATION_ID | Requests a connection test. Unsupported integrations may reject it. |
aipctl model list | None | Lists model IDs. |
Organization members
Invite, change roles, and remove members
Organization management permissions and policies apply.
| Command | Inputs and key options | Behavior and notes |
|---|---|---|
aipctl admin org invite | EMAIL [EMAIL ...] [--role ROLE] | Invites up to 100 addresses. Default role: member. Some invitations may fail. |
aipctl admin org remove-member | EMAIL [EMAIL ...] --force | Removes members after you check their current status. |
aipctl admin org update-member-role | EMAIL [EMAIL ...] --role ROLE | Changes roles. Values: owner, admin, aiOperator, member. |
Organization agent management
Creation and update JSON, deletion, and export
AI Operator permissions and agent management policies apply.
| Command | Inputs and key options | Behavior and notes |
|---|---|---|
aipctl admin agent create | JSON_FILE | Creates an agent from JSON. Check remaining settings and activation separately. |
aipctl admin agent update | AGENT_ID JSON_FILE | Updates settings using JSON appropriate to the agent type. |
aipctl admin agent delete | AGENT_ID --force | Deletes after you check dependencies. |
aipctl admin agent share | AGENT_ID | Queries sharing settings. Does not change sharing targets. |
aipctl admin agent templates | None | Lists agent templates. |
aipctl admin agent export | AGENT_ID [--output FILE] | Saves YAML. Also accepts -o; defaults to AGENT_ID.yaml. |
Organization skill management
Shared organization skills · GitHub import · PAT management
Requires AI Operator permissions.
| Command | Inputs and key options | Behavior and notes |
|---|---|---|
aipctl admin skill list | [--search TEXT] [--page N] [--page-size N] [--json] | Lists organization skills by page. |
aipctl admin skill get | SKILL_ID [--json] | Shows skill details and GitHub connection information. |
aipctl admin skill upload | FILE [--overwrite] | Uploads an organization skill. Review whether to replace the same name. |
aipctl admin skill download | SKILL_ID [-o FILE] | Downloads an organization skill. Overwrites destination files. |
aipctl admin skill delete | SKILL_ID --force | Deletes an organization skill. |
aipctl admin skill publish | SKILL_ID | Publishes to the library. |
aipctl admin skill unpublish | SKILL_ID | Removes library visibility. |
aipctl admin skill built-in | [--search TEXT] | Lists built-in skills. |
aipctl admin skill clone-built-in | SKILL_ID [SKILL_ID ...] | Clones up to five built-in skills. Check each result. |
aipctl admin skill github inspect | GITHUB_URL [--pat-env ENV_NAME] [--json] | Shows repository and branch information. |
aipctl admin skill github import | GITHUB_URL [--pat-env ENV_NAME] [--overwrite] [--json] | Imports organization skills from a repository or skill folder. |
aipctl admin skill github sync | SKILL_ID [--apply] [--json] | Checks changes by default. Updates only with --apply. |
aipctl admin skill github credentials set | SKILL_ID --pat-env ENV_NAME | Saves or changes the skill’s GitHub PAT. Pass the environment variable name. |
aipctl admin skill github credentials clear | SKILL_ID | Removes the saved PAT. Does not revoke the token on GitHub. |
Integration management
Integration details and tool lists
Requires AI Operator permissions.
| Command | Inputs and key options | Behavior and notes |
|---|---|---|
aipctl admin integration available | None | Lists available integrations. |
aipctl admin integration get | INTEGRATION_ID | Shows detailed integration settings. |
aipctl admin integration tools | INTEGRATION_ID | Shows tool names, descriptions, and policy status. Does not run tools. |
aipctl admin integration update | INTEGRATION_ID JSON_FILE | Updates using the integration’s required JSON format. Do not pass raw query results. |
aipctl admin integration delete | INTEGRATION_ID --force | Deletes after checking agents and presets that use it. |
Usage and audit logs
Usage queries require organization administrator permissions. Audit logs require the appropriate plan and access. The default usage period is this month’s first day through today; use YYYY-MM-DD dates.
| Command | Inputs and key options | Behavior and notes |
|---|---|---|
aipctl admin usage credit | [--start DATE] [--end DATE] | Shows credit usage and user statistics for the period. |
aipctl admin usage top-users | [--start DATE] [--end DATE] [--limit N] | Ranks user usage. Defaults to the top 10. |
aipctl admin usage daily-graph | [--start DATE] [--end DATE] | Shows daily usage. |
aipctl admin usage daily-users | [--start DATE] [--end DATE] [--page N] [--user-id USER_ID] | Shows daily user statistics, optionally filtered by user. |
aipctl admin usage mcp-top | [--start DATE] [--end DATE] [--limit N] | Ranks MCP tool usage. Defaults to the top 10. |
aipctl admin audit list | [--type EVENT_TYPE] [--page N] | Queries audit logs by event type and page. |
aipctl admin audit types | None | Lists audit event type identifiers. |
PC tunnel connection
Get a token from the web interface’s PC connection instructions. It is separate from sign-in for general management commands.
| Command | Inputs and key options | Behavior and notes |
|---|---|---|
aipctl tunnel link | CONNECTION_TOKEN | Connects the PC tunnel. Keep the process running while working; stop with Ctrl+C. |
aipctl admin tunnel status | [--org ORG_SLUG] | Shows your connection status in the organization, not all organization connections. |
aipctl admin tunnel config | [--show-sensitive] [--org ORG_SLUG] | Shows the connection command and connection counts. Secrets are masked by default. |
aipctl admin tunnel token | [--org ORG_SLUG] | Requests token creation. Successful output does not display the token itself. |
Output and failure handling
- Scripts and list queries: JSON support, page options, and exit codes
- Limitations and troubleshooting: authentication, permissions, limits, query restrictions, and uncertain change outcomes
Append --help to a command to check its required inputs. Help does not execute the operation.