Need help with Terminal Widget?
Post an issue on GitHub — the preferred way to request support. Issues are public, so others with the same question can find answers, and they help us track bugs and feature requests.
Prefer email? Contact Brett directly at tw@brettterpstra.com.
iOS and iPadOS setup
After installing TerminalWidget on iPhone or iPad:
- Open the TerminalWidget app at least once so it can register for iCloud sync.
- Add a widget to the Home Screen and set its target to match the widget ID you update from your Mac, Shortcuts, or URL scheme.
- Allow notifications for TerminalWidget. Go to Settings > Notifications > TerminalWidget and turn notifications on. The app uses push notifications to wake for iCloud pulls when another device updates a widget. If notifications are disabled, widgets may not refresh until you open the app manually.
- Confirm you are signed into iCloud on the device with the same Apple ID used on your Mac.
If widgets still look stale, open TerminalWidget, tap the menu, choose Refresh, then open Info/Debug and check Last pull under Cloud sync. A successful pull updates that timestamp.
Notify-on-change alerts (from --notify, URL notify=1, or Shortcuts) also require notification permission on iOS and iPadOS.