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.open	Links Open ...
links.refresh	Refresh Links
links.enterSearch	Enter Search Mode
links.exitSearch	Exit Search Mode
links.openUrl	Open Link
links.copyUrl	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