Jumper for VSCode

Navigate to your most frequently and recently used files and directories instantly with jumper's frecency algorithm.

Demo

Why Jumper?

• 🚀 Lightning fast - Jump to files in milliseconds using frecency ranking
• 🧠 Smart learning - Automatically ranks files by frequency and recency
• 🔄 Consistent across editors - Shared database between the shell and VS Code

Quick Start

1. Install jumper CLI

First, install the jumper command-line tool:

• macOS:

brew install homerours/tap/jumper

• archlinux: an AUR package is available:

yay -S jumper

• other OS: you can either download pre-built packages on the Releases page, or follow the instructions below to install from source.

Then, set up your shell following these instructions.

Install from source

A C compiler is needed to install from source. The makefile uses gcc.

Install script

You can use the install script to clone and compile jumper + set up the shell keybindings automatically:

PREFIX=$HOME/.local/bin sh -c "$(curl -s https://raw.githubusercontent.com/homerours/jumper/master/install.sh)"

Manual installation

Alternatively, you can run

git clone https://github.com/homerours/jumper
cd jumper
make install

to compile and move the jumper binary to /usr/local/bin. You then have to setup your shell as follows.

See jumper installation guide for more options.

2. Install the extension

From the marketplace:

Install from the VSCode Marketplace or search for "Jumper for VSCode" in the Extensions view.

Manual installation (advanced):

If you want to install a specific version or test unreleased versions:

1. Download the .vsix file from GitHub Releases

2. Install via command line:

   code --install-extension jumper-vscode-VERSION.vsix
   

3. Or install via VSCode UI:

   • Press Cmd+Shift+X (Mac) or Ctrl+Shift+X (Win/Linux)
   • Click the ... menu → "Install from VSIX..."
   • Select the downloaded .vsix file

3. Start jumping!

• Press Ctrl+Alt+U to jump to a file
• Press Ctrl+Alt+Y to jump to a directory

The extension automatically learns your file access patterns as you work.

Features

Jump to Files (Ctrl+Alt+U)

Search and open files from jumper's database with live query updates. Files you use most frequently and recently appear first.

Jump to Directories (Ctrl+Alt+Y)

Search for a directory, then browse and open files within it. Perfect for navigating large projects.

Automatic Tracking

The extension automatically updates jumper's database:

• When you open a file
• When you save a file
• When you change workspace folders

Live Query Updates

Unlike standard VSCode file pickers, queries are sent directly to jumper as you type, with no additional VSCode filtering.

Customization

Keybindings

Default shortcuts:

• Ctrl+Alt+U - Jump to File
• Ctrl+Alt+Y - Jump to Directory

To customize:

1. Open Keyboard Shortcuts: Cmd+K Cmd+S (Mac) or Ctrl+K Ctrl+S (Win/Linux)
2. Search for "jumper"
3. Click a command and press your desired key

Tip: If you use the Neovim plugin, you can set Ctrl+U and Ctrl+Y for consistency.

Settings

Configure jumper's behavior in VSCode settings:

How It Works

Jumper uses a frecency algorithm (frequency + recency) to rank files and directories:

• Recently accessed items rank higher
• Frequently accessed items rank higher
• The ranking adapts to your workflow automatically

The database is shared across:

• Shell (jumper CLI)
• Neovim (jumper.nvim)
• VSCode (this extension)

Troubleshooting

"jumper is not installed" error

Install the jumper CLI tool following the installation guide.

No results showing

The database builds over time as you use it. Try opening some files first, or use jumper in your shell to populate it faster.

Keybindings not working

The default shortcuts may conflict with other extensions. Check Keyboard Shortcuts (Cmd/Ctrl+K Cmd/Ctrl+S) and customize as needed.

Related Projects

• jumper - The core CLI tool
• jumper.nvim - Neovim plugin
• jumper.vim - Vim plugin

Credits

Created by homerours. Inspired by z and other frecency tools.

License

MIT