File Explorer Tools

Color-coded file scopes, recursive folder expand, and automatic symbol rename on file rename — power tools for the VS Code Explorer

Why I Built This

I work on a large monorepo with hundreds of folders and thousands of files. Every day I'd find myself collapsing and expanding the same subtrees, losing track of which files belong to the feature I'm working on, and manually renaming classes after renaming files. Small frictions, but they add up to real time lost.

VS Code's built-in Explorer is surprisingly barebones for a tool developers live in all day. There's no way to bookmark a subset of files, no recursive expand button, and renaming a file doesn't touch the symbols inside it. I looked at what's out there — extensions like File Nesting Updater or Explorer Exclude solve narrow problems but don't address the broader workflow. Peacock colors your workspace, not your files. Nothing gave me a way to say "these 12 files are my current scope" and just hide everything else.

So I built File Explorer Tools — a small, focused set of power-ups for the Explorer panel that I actually needed every day:

• Scope filtering so I can zoom in on just the files that matter for a given task, without setting up a multi-root workspace or touching .gitignore
• Recursive expand because clicking 30 folders one by one is not a workflow
• Rename cascade because if I rename user-service.ts to account-service.ts, the class inside should follow — and so should every import across the project

Why File Explorer Tools?

• Universal Compatibility: Works with VSCodium, Cursor, Windsurf, and other VS Code forks. Published to the Open VSX Registry for the broadest reach.
• Native Integration: No custom tree views or side panels. Scopes filter the actual built-in File Explorer via files.exclude, so everything — search, quick open, git — stays consistent.
• Zero Config: Install and go. No JSON files to create, no settings to tweak. Right-click a file, add it to a scope, done.
• Lightweight: No background processes, no file watchers polling your disk, no telemetry. Just three focused features that do their job and get out of the way.
• Version Control Friendly: Shared scopes live in .vscode/scopes.json so your team can commit and share them. Personal scopes stay local.

Scopes Manager

Assign files and folders to named, color-coded scopes directly from the Explorer context menu. When a scope is selected, the native File Explorer filters down to show only the files that belong to it — powered by files.exclude under the hood.

• Create unlimited scopes with 6 color presets (Red, Blue, Green, Yellow, Orange, Purple)
• Add files or entire folders to a scope via right-click or keyboard shortcut
• Click a scope in the Explorer sidebar to filter the File Explorer to just that scope's files
• Click again or press the deselect button to restore the full file tree
• File decoration badges show which scope each file belongs to

Commands

Keybindings

Keybindings are active when the File Explorer is focused.

Context Menus

• Explorer context menu — Add to Scope, Remove from Scope
• Scopes list context menu — Delete, Rename, Change Color, Clear Patterns

Settings

Shared scopes are stored in .vscode/scopes.json and can be committed to version control.

How It Works

Scope filtering uses the native VS Code files.exclude workspace setting. When you select a scope, the extension computes which files and folders are not part of the scope and temporarily adds them to files.exclude. Deselecting the scope restores the original exclude list. This means filtering works with the built-in File Explorer — no custom tree views needed.

Expand Recursively

One-click recursive expansion of all folders in the File Explorer. Appears as an icon in the Explorer title bar.

• Expand entire workspace or a specific folder from the context menu
• Configurable exclude list (skip node_modules, dist, .git, etc.)
• Progress notification with cancel support

Commands

Context Menus

• Explorer context menu — Expand Recursively (folders only)
• Explorer title bar — expand-all icon button

Settings

How It Works

Walks the directory tree using the VS Code filesystem API, expanding each folder via revealInExplorer and list.expand. Folders matching the exclude patterns are skipped automatically.

Rename Cascade

When you rename a file in the Explorer, the matching class or export inside it is automatically renamed too (using the language server's rename provider), cascading the change across the entire project.

• Converts file base names to PascalCase to find the matching symbol (e.g., foo-entity → FooEntity)
• Handles compound extensions: foo-bar.component.ts → FooBarComponent
• Supports .ts, .tsx, .js, .jsx, .java, .kt, .cs, .py, .go
• Three modes: auto-rename, prompt for confirmation (default), or disabled

Examples

Settings

How It Works

Listens for onDidRenameFiles events, strips the language extension, derives the old and new PascalCase symbol names from the remaining file name (including compound parts like .component, .module), finds the old symbol in the file content, and invokes vscode.executeDocumentRenameProvider to rename it project-wide.