VScope
Fuzzy file search and live grep for VS Code, powered by fzf and ripgrep. Inspired by Telescope.nvim.
Features
- Fuzzy file search — find files by name across your workspace with fzf ranking
- Live grep — search file contents with ripgrep as you type
- LSP pickers — references, definitions, implementations, and type definitions for the symbol under the cursor, ranked by an in-process fzy scorer
- Diagnostics — workspace-wide list of errors, warnings, info, and hints with a severity badge
- Open Editors — fuzzy-jump across the editors you currently have open across all tab groups
- Document Symbols — flat hierarchical view of the active file's classes / functions / variables, indented by depth, with kind badges
- Workspace Symbols — live LSP query for symbols across the entire workspace, ranked by the active language server
- Syntax-highlighted preview — renders the selected file using your active VS Code theme
- Split panel UI — resizable file list and preview pane, draggable divider
- Virtualized list — handles large workspaces without slowdown
Requirements
fzf on your PATH (used for file name fuzzy matching)ripgrep — bundled with VS Code; a system install is used as fallback
Usage
| Action |
Keybinding |
| Find files |
alt+; f |
| Live grep |
alt+; g |
| Find LSP references (symbol under cursor) |
alt+; r |
| Find LSP definitions (symbol under cursor) |
alt+; d |
| Find LSP implementations (symbol under cursor) |
alt+; i |
| Find LSP type definitions (symbol under cursor) |
alt+; y |
| Diagnostics |
alt+; x |
| Open editors |
alt+; b |
| Document symbols (active file) |
alt+; s |
| Workspace symbols |
alt+; w |
| Move selection down / up |
ctrl+n / ctrl+p |
| Scroll preview down / up |
ctrl+d / ctrl+u |
| Scroll preview left / right |
ctrl+f / ctrl+k |
| Zoom file list / preview pane |
alt+, / alt+. |
| Open selected file |
Enter or double-click |
| Close |
Escape |
Switch between file search and grep with the files / grep button or by pressing Escape when a pane is zoomed.
Customizing Keybindings
All keybindings can be rebound via VS Code's keybindings editor:
- Open the editor with
Ctrl+K Ctrl+S (macOS: Cmd+K Cmd+S)
- Search for
vscope
- Click the pencil icon next to any binding and press your preferred key combination
The in-panel navigation keys (ctrl+n, ctrl+p, etc.) only fire while VScope is open — they won't interfere with your normal editor bindings.
| |
