Deeplinks Support
Vyre IDE supports custom OS-level URL protocols. Learn how to trigger agent runs, open specific files, or configure workspaces directly using `vyre://` deeplinks from web browsers, Slack, or documentation pages.
URL Protocol
Vyre registers the vyre:// protocol on installation. When clicked, these links open Vyre IDE and trigger the requested actions.
The general structure of a Vyre deeplink is:
vyre://[action]?[parameters]Action Types
| Action | Parameters | Description |
|---|---|---|
open | path, line | Open a local file at a specific line. |
agent | task, project | Launch an agent task in a given folder. |
clone | url | Clone a git repository and open it. |
settings | page | Navigate to a specific IDE settings screen. |
Common Integrations
Open File in IDE
Construct links to instantly navigate team members to exact lines of code: vyre://open?path=/app/index.js&line=45
Trigger Task from Web
Embed buttons in your web app to launch code generation runs: vyre://agent?task=Add+new+endpoint
Clone & Open
Allow users to download and launch projects with one click: vyre://clone?url=https://github.com/org/repo
Browser Extension Integration
Use deeplinks to connect custom browser plugins or devtools directly into your desktop IDE workspace.
CLI Link Trigger
You can also trigger deeplinks from the terminal shell via the CLI:
vyre open-link "vyre://open?path=src/main.ts&line=12"When opening vyre:// links from browser environments, a system prompt asking "Open Vyre?" is typically shown for security reasons. Users must accept to proceed.
Security Restrictions
To prevent malicious execution, Vyre blocks dangerous command flags when launched via deeplinks. Tasks containing write operations always require manual user confirmation before starting.