Wox Plugin Creator
Quick Start
- •Scaffold a Node.js plugin (clones template repo):
- •
python3 scripts/scaffold_wox_plugin.py --type nodejs --output-dir ./MyPlugin
- •
- •Scaffold a Python plugin (clones template repo):
- •
python3 scripts/scaffold_wox_plugin.py --type python --output-dir ./MyPlugin
- •
- •Scaffold a script plugin (uses local templates; plugin-id auto-generated; single file output):
- •
python3 scripts/scaffold_wox_plugin.py --type script-nodejs --output-dir ./Wox.Plugin.Script.MyScript.js --name "My Script" --trigger-keywords my
- •
Workflow
1) Scaffold plugin files
- •Use
scripts/scaffold_wox_plugin.pyfornodejs,python,script-nodejs, orscript-python. - •For Node.js and Python, the scaffold clones the official template repos and replaces placeholders like
{{.ID}},{{.Name}},{{.Description}},{{.TriggerKeywordsJSON}},{{.Author}}. - •Script plugins are single-file plugins. Prefer filenames like
Wox.Plugin.Script.<Name>.<ext>(e.g.,Wox.Plugin.Script.Memos.py). - •For script plugins, the scaffold copies Wox script templates from
~/.wox/ai/skills/wox-plugin-creator/assets/script_plugin_templates/and fills metadata placeholders. - •Prefer standard library features; avoid third-party dependencies unless absolutely necessary.
- •For SDK usage and API details, read
references/sdk_nodejs.mdorreferences/sdk_python.md.
2) Package and publish
- •For SDK plugins cloned from templates, run
make publishinside the template repo. - •Publishing notes:
references/publishing.md.
Resources
- •scripts:
scripts/scaffold_wox_plugin.py,scripts/package_plugin.py - •references:
references/plugin_overview.md,references/scaffold_nodejs.md,references/scaffold_python.md,references/sdk_nodejs.md,references/sdk_python.md,references/plugin_json_schema.md,references/plugin_i18n.md,references/publishing.md - •assets:
assets/script_plugin_templates/