Organize your workspace with customizable folder shortcuts and logical groups. Quick access to frequently used directories and files with split-view navigation.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Organize your workspace with customizable groups of shortcuts. Quick access to frequently used directories and files with intuitive organization and split-view navigation.
Features
📁 Shortcut Groups
Custom Organization: Create custom groups to organize files and folders by project, type, or workflow
Flexible Management: Add any files and folders to groups, organizing them however makes sense for you
Quick Access: Instant access to frequently used locations from a single, unified view
Auto-Refresh: Automatically refreshes tree view when files/folders in watched directories change
Split View Navigation: Open files and folders in a split pane or replace current view
Drag and Drop: Move files and folders by dragging them to different locations
Group Operations: Create, rename, delete groups and manage their contents
Tree View: Hierarchical display of groups and their items
Context Menu Actions: Right-click for quick actions on groups and items
☁️ Cloud Sync (New!)
Multi-Device Sync: Keep your shortcuts synchronized across all your devices
Multiple Providers: Choose from VSCode Settings Sync or Azure Blob Storage
Automatic Sync: Changes automatically sync to cloud (configurable)
Secure Storage: Credentials encrypted via VSCode's SecretStorage API
Manual Control: Trigger sync manually or configure automatic intervals
⌨️ Keyboard Navigation
Enter: Open item in current view
Space: Open item in split view
F2: Rename selected item
Delete: Remove selected item
Ctrl+Z / Cmd+Z: Undo last move operation
Arrow Keys: Navigate and expand/collapse groups
Home/End: Jump to first/last item
Installation
Open VSCode
Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
Search for "Workspace Shortcuts"
Click Install on the extension by yihengtao
Usage
Getting Started
After installation, you'll see the Shortcuts icon in the Activity Bar
Click on it to open the Shortcuts panel
Create groups to organize your files and folders
Creating Groups
Click the "+" button in the Shortcuts panel
Enter a name for your group (and optional description)
Right-click on the group to add folders or files
Organize your shortcuts however makes sense for your workflow
Adding Files and Folders to Groups
Right-click on any group
Select "Add to Group"
Choose files and/or folders to add (multi-select supported)
Your items will appear in the group for quick access
Navigation Options
Single Click: Navigate to the folder/file
Space Bar: Open in split view (when focused)
Right Click: Access context menu for rename, remove, etc.
Moving Files and Folders with Drag and Drop
Drag: Click and hold on any file or folder
Drop: Drag it to a folder where you want to move it
Confirm: If a file with the same name exists, you'll be prompted to overwrite or skip
Result: The file/folder is moved to the new location on your filesystem
Undo: Press Ctrl+Z (or Cmd+Z on Mac) to undo the last move within 1 minute
Note: Drag and drop performs an actual file system move. Undo is available for the last move operation within 1 minute.
Setting Up Cloud Sync
Configure Sync Provider:
Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
Run "Shortcuts: Configure Cloud Sync"
Select one or more providers (VSCode Sync or Azure)
Provider-Specific Setup:
VSCode Settings Sync (Easiest):
Choose scope (Global or Workspace)
Automatically syncs with your Microsoft/GitHub account
No additional credentials needed
Azure Blob Storage:
Enter container name and storage account name
Provide connection string or SAS token
Ensure container exists or has create permissions
Enable Sync:
Run "Shortcuts: Enable Cloud Sync" or enable during configuration
Your configuration will automatically sync on changes
Monitor Sync:
Use "Shortcuts: Show Sync Status" to check sync status
Use "Shortcuts: Sync Now" to manually trigger sync
Toolbar buttons visible when sync is enabled
Sync Behavior
Automatic Sync: Configuration changes are automatically uploaded (debounced by 2 seconds)
Conflict Resolution: Last-write-wins - the newest configuration is always used
Multi-Provider: Can sync to multiple providers simultaneously
Device Tracking: Each device has a unique ID for tracking changes
Periodic Check: Optional background checks for cloud updates (configurable interval)
Configuration
YAML Configuration File
The extension stores its shortcuts configuration in a YAML file (.vscode/shortcuts.yaml for workspace or ~/.vscode-shortcuts/.vscode/shortcuts.yaml for global). You can access the configuration file through the gear icon in the Shortcuts panel.
VS Code Settings
The extension provides the following VS Code settings (accessible via Settings UI or settings.json):
workspaceShortcuts.openMarkdownInPreview (default: false): When enabled, Markdown (.md) files will automatically open in preview mode instead of edit mode when created or opened from shortcuts.
Cloud Sync Settings
workspaceShortcuts.sync.enabled (default: false): Enable cloud synchronization of shortcuts configuration
workspaceShortcuts.sync.autoSync (default: true): Automatically sync configuration changes to cloud
workspaceShortcuts.sync.syncInterval (default: 300): Periodic sync interval in seconds (0 to disable)
Requirements
VSCode version 1.74.0 or higher
Node.js (for development)
Platform Notes
Windows: Due to OS limitations in native file dialogs, selecting both files and folders simultaneously in a single dialog is not supported. On Windows, right‑click a group and use "Add Files to Group" or "Add Folders to Group". On macOS/Linux, the single "Add to Group" entry allows selecting both in one dialog.
If you encounter any issues, please file them on the GitHub repository.
