mentra-community Sync miniapp (prepare only — no git commits)
Command
From the MentraOS repo root:
bun scripts/sync-miniapp.mjs <name> [--bump patch|minor|major] [--no-bump] [--dry-run]
# or
bun scripts/sync-miniapp.mjs --repo /path/to/external-miniapp [--bump patch] [--dry-run]
Named repos live in scripts/miniapp-repos.json.
What it does
- Reads
miniapp.json(packageName + version are canonical). - Bumps strict
MAJOR.MINOR.PATCH(rejects prerelease/build unless--no-bump). - Runs the external repo's
bun run pack(or vendoredmentra-miniapp pack). - Verifies the zip's embedded
miniapp.json. - Copies into
mobile/assets/miniapps/, prunes older same-package zips. - Regenerates
mobile/src/generated/bundledMiniapps.ts.
Critical: no commits
This skill must not run git add, git commit, or git push in either the external miniapp repo or MentraOS.
After a successful run, tell the user:
No commits made. Remaining manual steps: commit+push in
<repoPath>, then commit the MentraOS changes.
Agent workflow
- Prefer
--dry-runfirst if the user wants a preview. - Run the script; do not reimplement pack/copy by hand.
- Report old → new version and destination zip path.
- Never commit unless the user explicitly asks in a separate request.