All pages

Docs · Background features

Sync

Availability: macOS.

TRMNLY does not run a live cross-device sync today. "Sync" is Export / Import bundles — a JSON file you can move between Macs.

Export

File → Export TRMNLY Settings…

You get a save panel with a checkbox: "Include agent sessions and runbooks." The bundle includes:

  • Saved prompts (and which one is pinned)
  • Projects (and which one is current)
  • Agent preferences (default model, auto-approve)
  • Which right-sidebar tab was selected
  • If checked: agent sessions, runbooks, and per-project agent settings

The bundle never contains:

  • API keys (those live in Keychain)
  • Theme / font / keybinding overrides (device-local)
  • Open scrollback or terminal state

Connections, tab-monitor rules, and plugins don't travel in the bundle today.

Secret scan before write

Before writing the file, TRMNLY scans the JSON for key-shaped strings — patterns like sk-…, AIza…, AKIA…, Slack xox…, GitHub tokens, PEM private keys, and bearer tokens. (Generic high-entropy strings are deliberately left alone so normal output isn't mangled.) If anything matches, you get a confirm dialog listing samples:

  • Export redacted (the default) — replace findings with [REDACTED:…] placeholders before writing
  • Export raw (unsafe) — write the file anyway
  • Cancel

This is on by default because settings bundles travel through email, Dropbox, gists, and Slack — places where a leaked key won't get noticed for a while.

Import

File → Import TRMNLY Settings…

Opens the bundle and compares it against your current state. If nothing differs you get a quick confirm listing what's inside; otherwise a conflict resolver appears:

  • Per-setting conflicts show Local vs Incoming side by side — click the one to keep.
  • Collections (prompts, projects, sessions, runbooks) offer "Keep local only," "Use incoming only," or "Merge by id (newest wins)."
  • "Keep all local" / "Use all incoming" resolve everything in one click, then Apply.

Repeated imports don't duplicate entries — prompts and projects merge by id.

Practical setups

  • One-shot migration to a new Mac: export, AirDrop the file, import.
  • Periodic backup: keep the bundle in iCloud Drive / Dropbox; replace it on a schedule.
  • Team shared baseline: a "starter pack" bundle of prompts and projects; new teammates import once.

Live cross-device sync isn't shipping yet.