Control Air Explorer with AI (Claude, ChatGPT & Antigravity)
Air Explorer ships an AI Skill that lets AI assistants operate your cloud storage for you — list, search, upload, download, move, copy, sync and share files across all your connected clouds — by driving Air Explorer's command line.
Ask in plain language ("upload every PDF in my Downloads folder to the Backup folder of my Google Drive") and the assistant runs the right Air Explorer commands on your PC.
The skill uses the open Agent Skills standard (SKILL.md), so the same skill works in Claude Code, ChatGPT/Codex and Google Antigravity.
1. Requirements
Before installing the skill, make sure:
- Air Explorer Pro is installed and activated on this Windows PC.
- The command line is enabled: Options → Command line → Enable command line support.
- An AI assistant that runs on your computer and can execute local commands:
- Claude Code (CLI or the Claude Code tab of Claude Desktop)
- ChatGPT desktop app / Codex CLI
- Google Antigravity
- If you set a command line password in Air Explorer's preferences, the assistant must include it (it will ask you for it when needed).
Why a "local" assistant? The skill runs AirExplorerCmd.exe on your PC, so the assistant needs permission to run local commands. A purely web‑based chat cannot use it.
2. Install the skill
Open Air Explorer and go to Tools → AI Skills. Pick your assistant:
| Menu item | What it does |
|---|---|
| Install in Claude Code | Installs the skill for Claude Code / Claude Desktop's Claude Code tab. |
| Install in ChatGPT | Installs the skill for the ChatGPT desktop app and the Codex CLI. |
| Install in Antigravity | Installs the skill for Google Antigravity. |
| Manual installation | Opens the folder that contains the skill package (air-explorer-cli.zip) so you can add it by hand — see below. |
| Help | Opens this page. |
A confirmation appears when it's done. Restart the assistant so it detects the new skill. If the command line is disabled, Air Explorer offers to enable it for you.
The menu shows Install or Uninstall depending on whether the skill is already installed for that assistant. Air Explorer keeps the installed copies up to date automatically when you update the application.
Manual installation (any Agent Skills–compatible tool)
Some assistants let you add a skill by uploading a ZIP or by dropping a folder on disk. Use Tools → AI Skills → Manual installation — Air Explorer opens the folder and highlights air-explorer-cli.zip. Then follow your assistant's "add / upload a skill" flow and select that ZIP. Enable the skill afterwards if your assistant lists it with an on/off switch.
3. First run — verify it works
Restart your assistant after installing.
Ask: "List my Air Explorer accounts."
The assistant should run AirExplorerCmd accounts and show your configured clouds with their alias (the name you use to refer to each account).
If it can't find AirExplorerCmd.exe, make sure Air Explorer is installed and the command line is enabled, then try again.
4. What you can ask for
The skill can do everything the command line can. Typical requests:
Browse
"What's in the root of my Dropbox?" · "Show the folders in Backup on mydrive."
Search
"Find every invoice PDF larger than 2 MB in my OneDrive." · "Search my Google Drive for files modified after 2026‑01‑01."
Upload / download
"Upload C:\Reports\2026 to the Reports folder of mydrive." · "Download the Photos folder from my Dropbox to D:\Backup."
Move between clouds
"Copy everything in Archive from my Dropbox to my Google Drive."
Organize
"Create a 2026 folder in mydrive and move all *.xlsx from Inbox into it." · "Rename draft.docx to final.docx in my OneDrive."
Space
"How much free space is left on each of my accounts?"
Share
"Give read access to alice@example.com on the Shared folder of my Google Drive." · "Create a shareable link to report.pdf in my Dropbox."
Sync
"Mirror C:\Work to the Work folder of mydrive." · "Run my saved sync called NightlyBackup."
5. Command reference (summary)
Every request maps to one of these commands. The assistant builds them for you; this table is for reference.
| Command | Purpose |
|---|---|
accounts | List configured cloud accounts (get their aliases) |
dir | List files/folders in a cloud folder |
search | Search a cloud with filters (type, size, date, …) |
quota | Show used / free space |
upload / download | Local ⇄ cloud transfers |
transfer | Copy files from one cloud account to another |
copy / move / rename / delete / mkdir | Operate within one cloud |
zipupload | Zip a local folder, then upload it |
startsync / runsavedsync | Ad‑hoc or saved synchronization |
permissions | Show / grant / remove sharing permissions |
sharelink | Create a shareable link for a file or folder |
multicmd | Run a batch of commands from a file |
Exit codes: 0 success · 1 success (some files already up to date) · 2 nothing needed copying · 4 error · 8 partial error.
6. How paths work (important)
Getting paths right avoids the most common mistakes:
- Cloud paths use forward slashes / and start with the root folder name — never a leading slash and never backslashes:
- ✅ root/Documents/report.pdf
- ❌ root\Documents\report.pdf → Path not found
- ❌ /root/Documents → Path not found
- The first segment is the account's root folder name, which differs per provider (root, iCloud Drive, Dropbox, …). Ask the assistant to list the account first if unsure.
- Local Windows paths use backslashes \ and a drive letter, e.g. C:\Users\me\Documents.
The assistant follows these rules automatically — this section is here so the behavior is documented.
7. Example conversations
Example 1 — Discover accounts and browse
You: What cloud accounts do I have in Air Explorer?
Assistant: (runs AirExplorerCmd accounts) You have three:
- mydrive — Google Drive (juanjo@gmail.com)
- work‑onedrive — OneDrive for Business
- backup‑dropbox — Dropbox
You: What's in the root of mydrive?
Assistant: (runs AirExplorerCmd dir mydrive) The root has: Documents, Photos, Backup and 4 files. Want me to open any of them?
Example 2 — Upload with a wildcard
You: Upload all the PDFs in C:\Reports\2026 to a Reports folder on mydrive.
Assistant: I'll upload C:\Reports\2026\*.pdf to root/Reports (I'll create the folder if it doesn't exist). Running:
AirExplorerCmd upload "C:\Reports\2026\*.pdf" mydrive "root/Reports"
… Done — 12 files uploaded successfully.
Example 3 — Move files between two different clouds
You: Move everything in the Archive folder of my Dropbox to my Google Drive.
Assistant: That's a cloud‑to‑cloud transfer from backup‑dropbox to mydrive. To be safe I'll copy first, not delete. Running:
AirExplorerCmd transfer backup-dropbox "root/Archive/*" mydrive "root/Archive"
… 38 files transferred. Do you want me to delete them from Dropbox now?
Example 4 — Search with filters
You: Find invoices bigger than 1 MB in my OneDrive from this year.
Assistant: (runs AirExplorerCmd search work-onedrive "invoice" /type=document /largerthan=1MB /newerthan=2026-01-01 /fullpath)
Found 6 matching documents — here they are with their full paths…
Example 5 — Confirm before a destructive action
You: Delete the Old folder in mydrive.
Assistant: ⚠️ This will permanently delete root/Old and everything inside it in mydrive (some providers don't keep a recycle bin). It currently contains 214 files (3.1 GB). Type yes to confirm and I'll run AirExplorerCmd delete mydrive "root/Old".
Example 6 — Mirror a PC folder to a cloud
You: Mirror my local folder C:\Work\Project to the Project folder of mydrive.
Assistant: ⚠️ A Mirror sync makes the destination an exact copy of the source: files that exist in root/Project on mydrive but not in C:\Work\Project will be deleted so both sides match. The local folder stays untouched. I'll compare first so you can see what would change — no files moved yet:
AirExplorerCmd startsync Local "C:\Work\Project" mydrive "root/Project" Mirror /compareonly
… Comparison: 24 files to upload, 3 files to update, 2 files to delete on mydrive (old-notes.txt, draft-v1.docx). Shall I run the mirror for real?
You: Yes, and keep a report.
Assistant: Running the mirror with hash comparison and an HTML report:
AirExplorerCmd startsync Local "C:\Work\Project" mydrive "root/Project" Mirror /enablehash /reportfile="C:\Work\sync-report_{DATE}.html"
… Done — 24 uploaded, 3 updated, 2 deleted. Report saved to C:\Work\sync-report_2026-07-20.html.
Tip: to sync without ever deleting on the destination, ask for a MirrorUpdate or Update sync instead of Mirror.
8. Safety
- The assistant asks for confirmation before deleting or overwriting.
- Cloud deletions may be permanent depending on the provider.
- Long transfers stream progress; let them finish.
- The skill never sees your cloud passwords — it uses accounts you already signed in to inside Air Explorer.
9. Troubleshooting
| Symptom | Fix |
|---|---|
| "Command line support is disabled" | Enable it in Options → Command line, or let the Install dialog turn it on. |
| "The command line features are only valid for … Pro" | Activate an Air Explorer Pro license. |
| Assistant can't find the skill | Restart the assistant after installing; some list skills only at startup. |
| "Please include the configured command line password" | A CLI password is set in preferences — give it to the assistant when asked. |
| "Path … not found" | The path likely used \ or a leading /. Cloud paths use / and start with the root folder name. |
| Command lists the roots instead of the folder | The path started with /. Remove the leading slash (root/Folder, not /root/Folder). |
| Account "alias not found" | Run "list my accounts" to get the exact alias; add the account in Air Explorer's GUI if it's missing. |
10. Uninstall
Tools → AI Skills, then choose Uninstall from Claude Code / ChatGPT / Antigravity for the assistant you want to remove it from. For a manually added skill, remove it from your assistant's own Skills manager.
