composio-community/awesome-codex-skills / agent-deep-links
agent-deep-links
VerifiedBuild, validate, and troubleshoot deep links for Codex, Cursor, VS Code, Visual Studio, and similar tools. Use when users ask for clickable links (especially in Slack) that open threads, files, folders, or app settings.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.0 KB |
| agents/openai.yaml | config | 244 B |
| references/deep-link-matrix.md | markdown | 2.6 KB |
references/deep-link-matrix.md
View on GitHub# 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
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |