Hopkey

Hopkey is a keyboard-only jump mode for VS Code.

It lets you jump to nearby characters faster than moving with arrow keys.

Features

• Keyboard-first jump workflow.
• Visible character matches in the current viewport.
• Keycap-style labels for quick selection.
• Forward labels (a-z) and backward labels (A-Z).
• Paging support with Page Down and Page Up when many matches exist.
• Configurable case sensitivity.

Quick Start

1. Open a text editor in VS Code.
2. Press Ctrl+; (Windows/Linux) or Cmd+; (macOS).
3. Type the character you want to jump to.
4. Press the shown label key:
   • Uppercase label (A-Z) jumps backward.
   • Lowercase label (a-z) jumps forward.

If the label is valid, your cursor jumps to just before that character.

How It Works

1. Activate Hopkey.
2. Hopkey captures your next typed character as the target (it does not edit the document).
3. Matching visible characters are highlighted and labeled.
4. Type one label key to jump.
5. Hopkey exits and clears temporary decorations.

Controls

• Activate mode: Ctrl+; / Cmd+;
• Cancel mode: Esc
• Page to farther matches: Page Down
• Page back toward nearer matches: Page Up
• Click a highlighted match: jump and exit
• Click elsewhere while active: cancel

Configuration

Change Settings

Open VS Code settings file at settings.json:

1. Press Ctrl+Shift+P (or Cmd+Shift+P on macOS)
2. Run Preferences: Open User Settings (JSON)

Add or modify these settings:

{
  "hopkey.caseSensitive": false,
  "hopkey.languageOverride": "ja"
}

Available settings:

• hopkey.caseSensitive

  • true (default): C matches C only.
  • false: C matches both C and c.

• hopkey.languageOverride

  • auto (default): Uses VS Code's display language.
  • en, en-gb, es, fr, it, de, ja: Forces a specific language for status messages.

Change Keybindings

Open VS Code keybindings file at keybindings.json:

1. Press Ctrl+Shift+P (or Cmd+Shift+P on macOS)
2. Run Preferences: Open Keyboard Shortcuts (JSON)

Example: Change activation key to Ctrl+Alt+J

[
  {
    "key": "ctrl+alt+j",
    "command": "hopkey.activate",
    "when": "editorTextFocus"
  },
  {
    "key": "ctrl+;",
    "command": "-hopkey.activate"
  }
]

Example: Change cancel key to Escape (already default, but shown for reference)

[
  {
    "key": "escape",
    "command": "hopkey.cancelMode",
    "when": "hopkey.modeActive"
  }
]

You can bind any available key combination. Common examples:

• ctrl+alt+j – Control + Alt + J
• cmd+k – Command + K (macOS, or Control + K on Windows)
• alt+j – Alt + J
• ctrl+shift+; – Control + Shift + Semicolon

Notes

• Hopkey currently searches visible text in the editor viewport.
• If no valid target or label is provided, Hopkey cancels without changing document text.
• Keybindings are fully remappable in VS Code Keyboard Shortcuts.

Contributing

Interested in developing or packaging Hopkey? See CONTRIBUTING.md for setup instructions, build commands, and packaging details.