VSCode Launcher for DankMaterialShell

Note: This plugin was AI-generated using Claude (Anthropic) with human guidance and review.

A DankMaterialShell launcher plugin that provides quick access to Visual Studio Code recent files, folders, and projects with one-click opening.

Features

• Recent Files - Quick access to recently opened files from VSCode
• Recent Folders - Open recently used folders and workspaces
• Project Manager Integration - Load favorite projects from alefragnani.project-manager extension
• Git Worktree Extraction - Automatically expands projects with git worktrees into separate entries (e.g., project:branch)
• Multiple Editor Support - Works with VSCode, VSCodium, Cursor, Windsurf, Antigravity, and more
• Smart Filtering - Filter by type (file, folder, project) and search by name or path
• Configurable Trigger - Default vs, set your own trigger, or enable "Always Active" mode
• Custom Editor Support - Fully customizable config directory and executable path

Installation

From Plugin Registry (Recommended)

Via DMS Settings UI

1. Open DMS Settings with Mod + ,
2. Go to the Plugins tab
3. Click the Browse button
4. Search for "VSCode Launcher" and click Install
5. Restart your DMS session with Mod + Shift + R

Via dms CLI

# Install the plugin
dms plugins install vscodeLauncher

# Restart DMS to load the plugin
dms restart

Visit plugins.danklinux.com for the full plugin registry.

Manual Installation

# Copy plugin to DMS plugins directory
cp -r dms-vscode-launcher ~/.config/DankMaterialShell/plugins/

# Enable in DMS
# 1. Open Settings (Ctrl+,)
# 2. Go to Plugins tab
# 3. Click "Scan for Plugins"
# 4. Toggle "VSCode Launcher" to enable

Usage

Default Trigger Mode

1. Open launcher (Ctrl+Space)
2. Type vs followed by search query
3. Examples:
   • vs myproject - Find files/folders containing "myproject"
   • vs file config - Show only recent files matching "config"
   • vs folder work - Show only recent folders matching "work"
   • vs project app - Show only Project Manager projects matching "app"
4. Select item and press Enter to open in editor

Filter by Type

Use type keywords to filter results:

• file - Show only recent files
• folder - Show only recent folders
• project - Show only Project Manager projects

Examples:

• vs file ts - Find TypeScript files
• vs folder src - Find folders with "src" in path
• vs project frontend - Find projects named "frontend"

Configuration

Access settings via DMS Settings → Plugins → VSCode Launcher:

Editor Selection

• Editor: Select which editor to use (VSCode, VSCodium, Cursor, Windsurf, Antigravity, or Custom)
• Config Directory (Custom mode): Path to config directory (e.g., Code for ~/.config/Code/ or absolute path)
• Executable (Custom mode): Command or path to the editor executable

Trigger Settings

• Always Active: When enabled, items always show in the launcher without needing a trigger
• Trigger: The keyword to activate the plugin (default: vs)

Content Filters

• Show Recent Files: Toggle display of recent files
• Show Recent Folders: Toggle display of recent folders
• Show Project Manager Projects: Toggle display of Project Manager projects
  • Requires the alefragnani.project-manager extension
• Extract Git Worktrees: When enabled, projects with git worktrees are expanded into separate entries (e.g., project:main, project:feature-branch)
• Max Results: Limit the number of items displayed (10-200)

Supported Editors

The plugin supports the following editors:

Editor	Config Directory	Executable
VSCode	~/.config/Code/	code
VSCode - Insiders	~/.config/Code - Insiders/	code-insiders
VSCodium	~/.config/VSCodium/	codium
VSCodium - Insiders	~/.config/VSCodium - Insiders/	codium-insiders
Cursor	~/.config/Cursor/	cursor
Windsurf	~/.config/Windsurf/	windsurf
Windsurf - Next	~/.config/Windsurf - Next/	windsurf-next
Antigravity	~/.config/Antigravity/	antigravity
Custom	User-defined	User-defined

Requirements

• DankMaterialShell >= 0.1.0
• Visual Studio Code or compatible editor (VSCodium, Cursor, Windsurf, Antigravity)
• Optional: alefragnani.project-manager extension for project favorites

Compatibility

• Compositors: Niri and Hyprland
• Distros: Universal - works on any Linux distribution
• Editors: VSCode, VSCodium, Cursor, Windsurf, Antigravity (and their insiders/next variants)

Technical Details

• Type: Launcher plugin
• Trigger: vs (configurable)
• Language: QML (Qt Modeling Language)
• Dependencies: None (uses built-in file reading)

Data Sources

The plugin reads from:

• Recent Files/Folders: ~/.config/<editor>/User/globalStorage/storage.json
• Projects: ~/.config/<editor>/User/globalStorage/alefragnani.project-manager/projects.json

Troubleshooting

Editor not detected

• Ensure the editor is installed and in your PATH
• Use the "Custom Executable" setting if the editor is in a non-standard location
• Try running the editor from terminal to verify it's accessible

No items showing

• Check that the editor has been used to open files/folders
• Verify the config directory exists (~/.config/<editor>/User/globalStorage/)
• For Project Manager, ensure the extension is installed and has projects configured

Projects not showing

• Verify the Project Manager extension is installed
• Check that projects are enabled in Project Manager settings
• Ensure project root paths are valid and accessible

Contributing

Found a bug or want to add a feature? Open an issue or submit a pull request!

Credits

Inspired by albert-vscode - an Albert launcher extension for VSCode.

License

MIT License - See LICENSE file for details

Author

Created by SR_team for the DankMaterialShell community.

This plugin was AI-generated using Claude (Anthropic) with human guidance and review.

Links

• DankMaterialShell
• Plugin Registry
• albert-vscode