Relationship Companion

Clarity × Thread

A weather report for your texts — not surveillance.
local only

Free · private · no account

Your chat never leaves this device. Free means upload a .txt export or try the sample — everything parses and scores in your browser. No account, no cloud upload of message text — only optional localStorage for the last score snapshot.

Download Mac Live Sync

Download the installer, open the DMG, then double-click Install Relationship Companion. It’s signed with an Apple Developer ID and notarized by Apple, so macOS opens it normally.

Version 1.4: share a private live view with your partner, choose when to sync, and Desk server mode for desk Macs. Installing over an older version keeps your settings.

One-time: if chats look empty, macOS needs your permission to read Messages — System Settings → Privacy & Security → Full Disk Access → enable /usr/bin/python3. Live iMessage stays on your Wi‑Fi; nothing uploads unless you turn on the end‑to‑end encrypted live share.

Mac live sync

Same Wi‑Fi as the Mac running Mac Live Sync. Pick a thread, then tap Connect / refresh Mac to load — nothing uploads.

Mac Live Sync: use Download Mac Live Sync above (no source zip). After install, phone opens http://<your-mac>.local:8788/ on the same Wi‑Fi — live Messages, no export.
Phone app: On iPhone Safari use Share → Add to Home Screen. On Android Chrome use Install app / Add to Home screen. Works offline after first open.

Supports clean-format .txt (YYYY-MM-DD HH:MM | Name: text) and common WhatsApp exports. Installable phone app · offline shell · scores stay on-device.

Who is who

Favorability

—
—

Scored as of now; each signal is half absolute, half vs. their own last 4 weeks. Silence counts in real time.

Ball in court & last messages

Plans / next hang

Volume & signals

Advanced signals

Daily Volume

Today’s Warmth — Between You Two

Resets each calendar day. Bars = affection heat that hour; line = cumulative warmth through today.

Weekly Warmth

Timely view — last ~12 weeks of warmth vs volume.

Monthly Warmth

Long timeline — up to 12 months of warmth vs volume.

When they’re most responsive

By day of week

By time of day

Taller = faster replies (log scale of median reply time, relative within each chart); labels show the median. Dashed = only 1 reply sample; grey = activity only. Tap a bar for details.

Interest quotes

Insights

    Coaching blurb

    Methodology

    Heuristic dashboard from observable patterns: 7-day reciprocity, partner warmth keywords, recent 48h activity, plan momentum, reply-speed health, and silence health. Soft language only — never mind-reading. Treat scores as weather for bandwidth and tone.