Quick Start
This page takes you from installing OPW to having the AI create your first Pilot plugin. You only need to install OPW once, and all projects share it.
Before You Start
| Item | Requirement |
|---|---|
| Operating system | macOS (Apple Silicon / Intel) or Windows 10 22H2 / 11 x64 (PowerShell 5.1 / 7) |
| AI tool | Any of OpenCode, Claude Code, or Codex, installed and able to hold a conversation. If you do not have one yet, install OpenCode from the OpenCode download page. For other tools such as CodeBuddy and Trae, see Use OPW in Other AI Tools |
| Model service | An available model API key or a local model |
| Network | Node.js and npm dependencies are downloaded during installation |
You do not need to install Node.js in advance. The install script checks for Node.js 20.19 or later and npm, and downloads Node.js 24 LTS into your user directory when it is missing or too old. Your existing system Node.js is untouched, and no administrator permission is required.
Step 1: Download OPW
Download the OPW ZIP file from GitHub. The file name is open-pilot-wizard-installer-<version>.zip.
Step 2: Install OPW
Start a new session in the AI tool, replace <ZIP file path> with the actual path of the ZIP file, and enter:
I have downloaded the Open Pilot Wizard ZIP file to <ZIP file path>.
Follow INSTALL_AGENT.md in the ZIP file to install Open Pilot Wizard for me. Ask for approval when permissions are needed.
The AI extracts the file itself, explains what it is going to do, completes the installation after you authorize it, and reports the installed version and sync result. You still need to complete sign-in, key configuration, and license acceptance yourself.
Step 3: Create Your First Plugin
Open an empty directory in the AI tool and switch to the pilot-plugin-dev agent (in Codex, invoke the opw Skill directly; for how to switch in each tool, see Usage). Then enter:
Use OPW to create a Pilot plugin named "Route Assistant" with the default icon.
Start with the base page and the Pilot plugin entry. Ask me for all the information you need in one go.
What happens next:
- The AI asks for the project path, app name, package name, app icon, and App Key strategy in one go.
- After you confirm each item, the AI presents a plan and waits for your approval.
- After approval, the AI generates the project, runs the build, and reports the result and the APK path.
- Install the APK on the Remote Controller, or let the AI install it. Enable Route Assistant on the plugin management page in Pilot and confirm the base page opens.
Note: You can skip the App Key for now; it does not block getting the project running. Before calling MSDK capabilities, you must apply for and bind an App Key using the final package name on the DJI developer website.
Next Steps
- Usage: use OPW in an existing project, and develop features, debug issues, or migrate apps.
- Upgrade and Uninstall: update OPW or remove it.
- Troubleshooting: self-check, common issues, and issue reporting.