Skip to content

What the watch app does

The Apple Watch companion is small on purpose. It covers the things you’d reach for on a watch — what’s happening today, capture this thought before I lose it, what notifications need me — without trying to be the whole app.

You don’t sign in on the watch. Sign in on the iPhone, and the watch picks the session up over Apple’s Watch Connectivity framework. Specifically, on watch launch the watch app messages the iPhone with request-token and the phone replies with the JWT from its keychain. The token then lives in the watch’s own keychain (separate from the phone’s).

If the phone is unreachable on first launch, the watch shows “Open Moonjar on iPhone” and waits. Once the phone has been opened with you signed in, the next watch launch picks up the token.

Today — the daily-note view. Date header at the top. Below:

  • The day’s note (you can edit it).
  • The day’s timeline — captures, conversations, reminders due.
  • Two buttons: Add note (voice capture) and Summarise (generate or refresh the daily summary).

Alerts — the notifications inbox. Same notifications you see on the phone, with the same urgent-first ordering. Tap a row to expand it; swipe to dismiss; Clear all clears the whole list.

Tap Add note on the Today screen. The watch records audio locally (using watchOS dictation), uploads it to Moonjar, and files the result as a note document — same pipeline as the phone’s capture tab. The note appears in your library a few seconds later.

Tap Summarise on the Today screen. The watch calls Moonjar’s daily-summary endpoint for today’s date. The summary is rendered on the watch and cached for an hour — tapping again within the hour shows the cached version.

The watch calls a small subset of the API directly:

  • Daily notes — read and edit today’s note.
  • Daily summary — generate or read.
  • Capture — voice notes.
  • Notifications — list, mark read, dismiss.

Anything else (browsing documents, chatting, managing collections) isn’t on the watch. Use the phone.

  • No chat — the watch doesn’t have the full chat assistant. Quick capture creates a note; for an actual conversation, use the phone.
  • No complications yet — the watch face doesn’t show Moonjar data. v1 is a tap-to-open app surface only.
  • No push notifications direct to the watch — notifications arrive via the iPhone’s APNs delivery; the watch’s Alerts screen reads from the same notifications inbox the phone reads.
  • No offline editing — the watch needs an internet connection. Notes you start writing while offline aren’t queued.
  • Updates ship through the iOS App Store — there’s no separate watchOS App Store record. The watch app updates when you update the phone app.