Files, conversations, and integrations
Find file and conversation IDs, and check connected services and available models from your terminal.
View My Drive and manage folders
aipctl drive list
aipctl drive usageList My Drive items and check storage usage.
aipctl drive mkdir "Reports"
aipctl drive rename ENTRY_ID "New name"mkdir creates a folder at the root. The CLI does not let you specify a parent folder for creation. For rename, use the ID of the file or folder as ENTRY_ID.
aipctl drive list
aipctl drive delete ENTRY_ID --forceTo delete several items, separate their IDs with spaces. Check every target before running the command.
aipctl drive delete ENTRY_ID_1 ENTRY_ID_2 --forceDeleting a folder affects its contents. Check the target and contents first. Deletion is rejected if the folder and its descendants total more than 1,000 items; use the web interface to clean up in smaller batches.
Transfer My Drive files
Upload or download My Drive files you can access. Use the web interface where CLI transfers are restricted.
aipctl drive upload ./report.pdf
aipctl drive listUploads go to the root; there is no parent-folder option. Check the ID in the completion message and the file list. If storage or file limits cause a failure, check the cause before retrying. If the outcome is unclear, check the list before uploading a duplicate.
aipctl drive download ENTRY_ID --output ./downloads/report.pdfA destination path is required. You can use -o instead of --output. Existing files at that path are overwritten, so check the destination first. Verify the path and size in the success message. If the command is unavailable or rejected, transfer through the web interface.
View your conversations
aipctl chat list
aipctl chat get CONVERSATION_ID
aipctl chat messages CONVERSATION_IDYou can query only conversations you own. Organization administrators cannot use these commands to read all other users’ conversations.
- A conversation list returns up to 50 items per query.
- Message text masks sensitive information and shows up to 500 characters per message. Read the full content in the web interface.
chat messagesdoes not support--json.- Message queries are limited to 1,000 messages and 8 MiB of total data. Exceeding a limit returns an error rather than presenting a partial result as a success.
- Conversation details do not reproduce all attachments, tags, or archived state shown in the web interface.
To send a question to an agent, check version and server requirements, then see Chat with an agent. Send new messages in regular conversations through the web interface.
Check connected MCP servers
aipctl integration listCheck accessible integrations and policy status. AI Operators can also retrieve details, available integrations, and tool lists.
aipctl admin integration available
aipctl admin integration get INTEGRATION_ID
aipctl admin integration tools INTEGRATION_IDThe tool list shows names, descriptions, and policy status. It does not execute tools.
Test, update, or delete an integration
Test a connection or update and delete its settings. You need the permissions for each operation. Use the web interface where execution is restricted.
aipctl integration test INTEGRATION_IDThis requests a connection check for the external service. Review the success or failure message. On failure, check authentication and settings. Integrations that do not support connection tests may reject the request. A successful test does not guarantee that every tool will run successfully.
AI Operators can update or delete integrations where permitted.
aipctl admin integration get INTEGRATION_ID
aipctl admin integration update INTEGRATION_ID ./integration-update.json
aipctl admin integration get INTEGRATION_IDPrepare the update file using the format required by the integration and server version. There is no single JSON structure for all integrations, and detail query results should not be used directly as update input. If you cannot confirm the required format, configure the integration through the web interface. Restrict storage and sharing of files containing credentials.
aipctl admin integration delete INTEGRATION_ID --force
aipctl integration listDeletion can affect agents, presets, and other tasks using the integration. Check dependencies and the ID first, then verify the list after deletion.
Check available models
aipctl model listmodel list lists model IDs. It does not run models or generate images.