VS To Folder
A VS Codium extension that provides quick navigation to any folder in your workspace.
Features
- Quick Folder Navigation: Instantly find and navigate to any folder in your workspace
- Smart Filtering: Respects VS Code's
files.exclude
and search.exclude
settings
- Git Integration: Automatically excludes git-ignored directories
- Performance Optimized: Intelligent caching system to handle large workspaces efficiently
- Explorer Integration: Automatically reveals selected folders in the Explorer view
Usage
- Open the Command Palette (
Ctrl+Shift+P
/ Cmd+Shift+P
)
- Type "Find Folder" and select the command
- Browse or search through the list of available folders
- Select a folder to navigate to it in the Explorer
Alternatively, you can bind the vstofolder.FindFolder
command to a keyboard shortcut for even faster access.
Configuration
The extension contributes the following setting:
vstofolder.cacheValidationDuration
: Cache validation duration in minutes (default: 60)
- Set to
0
to disable caching
- Higher values improve performance but may not reflect recent filesystem changes
- Lower values ensure fresh results but may impact performance in large workspaces
How It Works
The extension scans your workspace folders and builds a directory tree while:
- Excluding hidden directories (starting with
.
)
- Respecting your VS Code exclude settings (
files.exclude
and search.exclude
)
- Filtering out git-ignored directories when a git repository is detected
- Caching results for improved performance on subsequent searches
Installation
Install from the VS Code Marketplace or package the extension locally:
npm install
npm run compile
Requirements
- VS Code 1.99.0 or higher
- Windsurf 1.0.0 or higher (compatible)
- Git extension (optional, for git-ignore functionality)
Known Issues
- Large workspaces may experience initial scanning delays
- Cache invalidation occurs on any file system change, which may impact performance in very active projects
For Developers
Building from Source
git clone https://github.com/bit4bit/vstofolder.git
cd vstofolder
npm install
npm run compile
npm test
Packaging
npm run package # Creates vstofolder-1.1.0.vsix
Testing in Development Mode
# Open project in VS Code/Windsurf
# Press F5 to launch Extension Development Host
# Test commands in the new window
Contributing
This extension is built with TypeScript and follows VS Code extension development patterns. Contributions are welcome!
License
See LICENSE file for details.