# Resurf links

> Open a capture or a screen, or save something, from any app with a resurf:// link.

- Page: https://resurf.so/guides/url-scheme
- Section: Agents
- Works on: Mac, iPhone, iPad
- Last checked against the app: 2026-10-17
- Start: Open a resurf:// link

## Open a link

On Mac:

1. Click a `resurf://` link, run `open "resurf://inbox"` in Terminal, or use a launcher's open-URL action.
2. When an agent links a capture's title in its answer, click it to open the capture in Resurf.

On iPhone and iPad:

1. Open a `resurf://` link, for example with an **Open URL** action in Shortcuts.

## Links on Mac

- `resurf://open/<capture id>` opens that capture.
- `resurf://inbox` opens the Inbox.
- `resurf://search` opens Quick Search.
- `resurf://connect-agents` opens **Settings → MCP**.
- `resurf://settings/<pane>` opens Settings at a pane, such as `general` or `sync`.
- `resurf://new?url=…` saves a link straight away, and `resurf://new?content=…` saves a text note. Add `title` or `tags` (comma-separated) if you like.

## Links on iPhone and iPad

- `resurf://open/<capture id>` opens that capture.
- `resurf://inbox` opens the Inbox.
- `resurf://capture/note?text=…`, `resurf://capture/quote?text=…` and `resurf://capture/link?url=…` save a note, a quote or a link. Without `text` or `url`, each opens its composer.
- `resurf://capture/voice` starts a voice note.
- `resurf://capture/paste` saves what's on the clipboard.

The `capture/` links are for iPhone and iPad only. On Mac, save with `resurf://new`.

## Questions

### How do I save a link from Raycast or Alfred on my Mac?

Open resurf://new?url= followed by the encoded URL. It saves straight away.

### How do I save a note from Shortcuts on iPhone?

Open resurf://capture/note?text= followed by the encoded text.

### I clicked a resurf://handoff link and nothing happened.

That link is for agents, not the app. An agent connected to Resurf reads it for you.

## More guides

- Previous: [Command line tool](https://resurf.so/guides/command-line.md)
- [Connect an agent](https://resurf.so/guides/connect-agents.md): Add Resurf to Claude, Cursor, Codex or another MCP client once, and it can search and read your captures.
- [What agents may do](https://resurf.so/guides/agent-access.md): A connected agent can always read your library, and three switches, off by default, decide what it may change.
- [Send captures to an agent](https://resurf.so/guides/send-to-agent.md): Open Claude, Codex, Cursor or another agent with a draft that carries your captures, then send it yourself.
- [Command line tool](https://resurf.so/guides/command-line.md): Search, read and add to your library from Terminal or a script with the resurf command.
- [Every guide](https://resurf.so/llms.txt)