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

• 🚀 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

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.

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

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)"

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.

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

• 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.

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

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

The extension automatically updates jumper's database:

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

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

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.

Configure jumper's behavior in VSCode settings:

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)

Install the jumper CLI tool following the installation guide.

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

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

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

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

MIT