JumpWise
Quickly and intelligently navigate between symbols (functions, classes, methods, etc.) in the current file with keyboard shortcuts. Supports both flat and hierarchical navigation, and works with nested symbols.
Features
- Jump to the next or previous symbol in the file
- Enter or exit nested symbol levels (e.g., inside classes or functions)
- Toggle between flat and hierarchical navigation
- Status bar shows symbol name and type
- Customizable keybindings
Commands
| Command |
Description |
jumpwise.nextSymbol |
Jump to the next symbol |
jumpwise.previousSymbol |
Jump to the previous symbol |
jumpwise.enterSymbol |
Enter the first child symbol |
jumpwise.exitSymbol |
Exit to parent symbol |
jumpwise.toggleFlatten |
Toggle between flat/hierarchical navigation |
Keybindings
| Command |
Default Keybinding (macOS) |
Default Keybinding (Windows/Linux) |
| Next Symbol |
Cmd+Alt+Down |
Ctrl+Alt+Down |
| Previous Symbol |
Cmd+Alt+Up |
Ctrl+Alt+Up |
| Enter Symbol Level |
Cmd+Alt+Right |
Ctrl+Alt+Right |
| Exit Symbol Level |
Cmd+Alt+Left |
Ctrl+Alt+Left |
| Toggle Nest Automatically |
(No default) |
(No default) |
Extension Settings
jumpwise.flattenSymbols (boolean, default: true):
- If enabled, navigation includes nested symbols (e.g., methods inside classes).
- If disabled, navigation is limited to the current symbol level.
Built-in VS Code Symbol Navigation
VS Code provides some built-in symbol navigation features:
- Go to Symbol in File... (
Cmd+Shift+O): Shows a list of all symbols in the current file for quick navigation.
- Go to Definition/Peek Definition (
F12, Cmd+Click): Jump to symbol definitions.
- Breadcrumbs: Shows the current symbol and allows navigation up the hierarchy.
Limitations of Built-in Features:
- There is no default keybinding for jumping directly to the next/previous symbol in the editor.
- There is no hierarchical navigation (enter/exit symbol levels) with keybindings.
How JumpWise is Different:
- Adds direct next/previous symbol navigation with keyboard shortcuts.
- Supports hierarchical navigation (enter/exit symbol levels).
- Displays symbol info in the status bar.
- Allows toggling between flat and nested navigation.
This extension provides unique navigation features not available in VS Code by default.
Requirements
- Visual Studio Code v1.74.0 or newer
Installation
- Open VS Code and go to the Extensions view (
Cmd+Shift+X or Ctrl+Shift+X).
- Search for
JumpWise and click Install.
Alternatively, you can install via the command line:
code --install-extension noname.jumpwise
Usage
- Use the keybindings or command palette to navigate between symbols.
- Toggle between flat and hierarchical navigation using the command
JumpWise: Toggle Nest Automatically.
- The status bar will show the current symbol's name and type.
If you are looking for similar functionality, you may also want to explore these extensions:
These extensions offer alternative or complementary symbol navigation features.
Contributing
Pull requests and suggestions are welcome! Please open an issue for bugs or feature requests.
License
MIT
