Settings and your data

Every setting, plus backups, import and export.

Open settings from the menu bar icon (Settings…, ⌘,) or the sidebar of the desktop window.

General

• Local port — where browsers and agents connect, 7787 by default. If it is taken at start, Waypoint uses the next free port and says so in the menu bar. A change applies after a restart. Agents set up with the old port need the new address.
• Close the tab after saving — when a tab is dropped into the panel or saved with ⌥⇧S. Off by default; applies in every browser.
• Link text and Link icons — small, medium or large, for every list of links here and in the browser panels.
• Updates — when Waypoint last looked for a new version; Check for Updates looks now, Install and restart installs a new one.
• The version and build of the app.

Browsers

The default order of browsers (and profiles) that links open in. See Open links in the right browser.

Rules

Test a URL, list, add and remove rules.

Extensions

Connected browsers, when each was last seen, and Revoke. See Connect a browser.

• Create sub-groups in the panel — the panel’s “+” on a group and “+ Sub-group”. On by default.
• Open one group at a time — opening a group in the panel closes the one that was open. Switch it off to keep groups open side by side, so you can drag a link from one into another. On by default.

Start page

Turn the start page on or off. When it is on, this section shows its address (with Copy), the two settings for Brave, a note for Firefox, and Import from Dashy….

Data

Everything stays on your Mac in one database file — encrypted, with its key in your Keychain, so other programs cannot read your links even while you are logged in. No account, no cloud.

• Backups — a copy is taken every day; the last 14 days are kept. Restore goes back to one, and keeps the current state as a backup too.
• Import — a Waypoint backup (JSON) merges in, newer changes win. Everything else lands in a new group (“Imported from … ”): folders and lists become sub-groups, tags become topics, read or archived items go into “Archive”. Sources: browser bookmarks (HTML export), Raindrop (CSV), Pocket (the zip as Pocket sends it, the CSV inside it, or the old ril_export.html), Instapaper (CSV) and Karakeep (JSON).
• Import from the browser itself — in the browser panel, below your groups: Import this browser’s bookmarks…. No export file needed. The browser asks once for access to your bookmarks; Waypoint reads them and gives the access back right away. The bookmarks bar and your folders become sub-groups of a new group. (Not in Safari.)
• Export — a full JSON backup to your Downloads folder: groups, facets, topics, rules and browser choices.
• Diagnostic log — Waypoint notes errors in a file on your Mac: never your links, titles, groups or notes, and it sends nothing. Show log opens it in Finder, to attach to an email or a GitHub issue when you ask for help. Turn on Detailed log when we ask for it; it then also holds the names of the GitHub repositories Waypoint reads.

Agents (MCP)

Agent tokens, setup commands and the undo list. See Agents.