67 lines
2.6 KiB
Markdown
67 lines
2.6 KiB
Markdown
# Deep Link Matrix
|
|
|
|
Last updated: 2026-02-10
|
|
Scope: practical deep links for agent workflows, especially Slack handoff links.
|
|
|
|
## Support Levels
|
|
|
|
- `Supported`: Officially documented and/or repeatedly verified.
|
|
- `Partial`: Works for some routes, but route coverage is incomplete.
|
|
- `Unknown`: Scheme exists, but route behavior is not clearly documented.
|
|
- `Not available`: No known official deep-link format.
|
|
|
|
## Matrix
|
|
|
|
| App | Scheme | Support | Known Link Patterns | Notes |
|
|
| --- | --- | --- | --- | --- |
|
|
| Codex Desktop | `codex://` | Supported | `codex://threads/<thread-uuid>`, `codex://threads/new`, `codex://settings` | Good for thread handoff links. |
|
|
| Cursor | `cursor://` | Supported | `cursor://file/<absolute-path>:<line>:<column>`, `cursor://file/<absolute-folder-path>/` | Works well for file/folder open links. |
|
|
| VS Code | `vscode://` | Supported | `vscode://file/<absolute-path>:<line>:<column>`, `vscode://file/<absolute-folder-path>/` | Requires VS Code installed on clicker machine. |
|
|
| VS Code Insiders | `vscode-insiders://` | Supported | `vscode-insiders://file/<absolute-path>:<line>:<column>` | Insiders-specific scheme. |
|
|
| Visual Studio (Windows IDE) | n/a | Not available | n/a | Use CLI fallback (`devenv /edit <path>`). |
|
|
| Claude Desktop | `claude://` | Unknown | `claude://...` | Scheme registration exists, but stable public route list is unclear. |
|
|
| Xcode | `xcode://` | Partial | `xcode://...` | Scheme exists; file-open route details are not well documented. |
|
|
| CLI-only agents | n/a | Not available | n/a | No standard clickable deep-link protocol without custom handlers. |
|
|
|
|
## Slack Format
|
|
|
|
Slack clickable links must be formatted as:
|
|
|
|
```text
|
|
<url|label>
|
|
```
|
|
|
|
Examples:
|
|
|
|
- `<codex://threads/123e4567-e89b-12d3-a456-426614174000|Open in Codex>`
|
|
- `<cursor://file/<absolute-path>:<line>:<column>|Open in Cursor>`
|
|
- `<vscode://file/<absolute-path>:<line>:<column>|Open in VS Code>`
|
|
|
|
## Verification Commands
|
|
|
|
Check app schemes:
|
|
|
|
```bash
|
|
/usr/libexec/PlistBuddy -c 'Print :CFBundleURLTypes' /Applications/<App>.app/Contents/Info.plist
|
|
```
|
|
|
|
Smoke test a deep link:
|
|
|
|
```bash
|
|
open '<scheme>://...'
|
|
```
|
|
|
|
## Fallback Patterns
|
|
|
|
When no deep link exists:
|
|
|
|
1. Provide the file path and app command (`devenv /edit`, `code`, etc.).
|
|
2. State that no official deep-link format is known.
|
|
3. Offer a supported alternative app link when possible.
|
|
|
|
## Sources
|
|
|
|
- Cursor deeplinks docs: https://cursor.com/docs/deeplinks
|
|
- VS Code URL docs: https://code.visualstudio.com/docs/editor/command-line#_opening-vs-code-with-urls
|
|
- Visual Studio CLI docs: https://learn.microsoft.com/en-us/visualstudio/ide/reference/devenv-command-line-switches?view=vs-2022
|