Skip to content

URL Scheme

Fox registers the fox:// URL scheme, which means any Fox issue can be addressed by a single link. Share links in chat messages, embed them in documentation, wire them into Shortcuts, or paste them into commit messages — tapping a fox:// link from anywhere launches Fox and navigates directly to the target.

The Format

fox://issue/PROJECT-REFERENCE

Examples:

  • fox://issue/FOX-042
  • fox://issue/NTFY-225
  • fox://issue/APP-1

The reference format is:

  1. A 1–4 character project prefix (the prefix you configured in project settings)
  2. A dash
  3. A numeric reference number

Opening a fox://issue/... link:

  • Launches Fox (or brings it to the front if already open)
  • Switches to the project the reference belongs to
  • Navigates directly to the issue
  • On iPad, may open the issue in its own floating window depending on context

Inline images in notes that reference issue attachments use a separate format:

fox://attachment/...

These are generated automatically by the Image Editor when you embed an existing attachment. You don't typically write them by hand.

Mac

Edit → Copy Path to Issue (⌘⌥C) copies the current issue's fox:// link to the clipboard.

iOS / iPadOS

Use the share sheet from an issue's detail view to copy or share the deep link.

Anywhere a URL works:

  • Chat messages — Paste fox://issue/FOX-42 into Slack, iMessage, Discord, or any chat app. The link is clickable on Mac and iOS.
  • Commit messages — Reference the issue your commit closes: Fix navigator crash — fox://issue/FOX-42
  • Documentation — Embed in markdown, HTML, or any other doc format
  • Email — Link to issues from email threads
  • Calendar events — Put a Fox link in a meeting description to jump straight into the issue being discussed
  • Shortcuts — Pass deep links between Shortcut actions, or open them with the Open URLs action
  • Apple Reminders — Paste a link into a reminder so tapping it opens the issue

Shortcuts can open fox:// URLs directly with the built-in Open URLs action. This is a quick way to build a shortcut that jumps to a specific issue — bind it to a home-screen icon for a one-tap "open my most important issue" button.

More complex integrations can use Fox's dedicated Shortcuts actions — see Shortcuts Automation.

Inside a Fox notes editor, you have two tools for the same job:

  • Wiki-links ([[) — Type-as-you-search, inserts a link with the issue's title as the visible text. Best for writing.
  • Deep links (fox://issue/FOX-42) — Stable URL, works anywhere. Best for pasting outside Fox.

Both navigate to the same place; they're just optimized for different situations. Inside notes, wiki-links are nearly always faster.

See Also