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.