VS Code Links

Pursue better UX for project links

🐛 Report Bug   •   ✨ Request Feature   •   🔍 View Source

---

Table of Contents

• Features
• Usage
• Commands
• Configurations
• Roadmap
• License

Features

• 🚀 One-click setup - Add project links directly in VS Code settings
• ⚡ Instant access - Open links with just a few keystrokes via Command Palette
• 🔧 Custom links - Define your own link resources with custom titles and URLs
• 🔍 Smart detection - Auto-discovers links from GitHub, CODING, and CNB repositories
• 🎯 Dynamic templates - Use {{repo.url}}, {{git.branch}} variables for context-aware links (see all variables)
• 📊 Tree view - Browse organized links with search and filtering in sidebar
• 📈 Status bar - Quick link count and access right from the status bar
• 👥 Team sharing - Share links via remote CSV files for team collaboration

Usage

1. Add your project links to .vscode/settings.json:

{
  "links.resources": [
    {
      "url": "https://github.com/yunsii/vscode-links",
      "title": "GitHub Repository"
    }
    // Add more links as needed
  ]
}

2. Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P on macOS).

3. Type Links: Open... and select it.

4. Choose the link you want to open in your default browser 🎉.

Commands

Command	Title
links.openPicker	Links: Open Picker
links.refresh	Links: Refresh
links.enterSearch	Links: Enter Search Mode
links.exitSearch	Links: Exit Search Mode
links.openUrl	Links: Open Link
links.copyUrl	Links: Copy Link URL

Configurations

Key	Description	Type	Default
links.resources	Local resources to open	array	``
links.remoteResources	Remote resources to open: set to an object with url and project. Leave unset (null) to disable.	undefined	``
links.customIcons	Custom icons for different link types	object	{ "local": "folder", "detected": "eye", "remote-project": "repo", "remote-shared": "share" }

Remote Resources Example

To use remote CSV resources, add this to your .vscode/settings.json:

{
  "links.remoteResources": {
    "url": "https://docs.google.com/spreadsheets/d/e/2PACX-1vRlzHErycXFRcNf2u9kB3SndusKyGaAEmoh2gueEKEtkTaibfMKKgOonlJhgBArqKrKJJlXthTo7LFN/pub?gid=0&single=true&output=csv",
    "project": "my-project"
  }
}

The CSV file should have columns: project (required), url (required), title (required), description (optional).

How it works:

• Links with project matching your configured project name appear as project-specific links
• Links with project: "#shared-links" appear as shared team links
• Other links are filtered out automatically

Roadmap

• Localization support for multiple languages

License

MIT License © 2025 Yuns