
Kangaroo
Move around your code at the speed of thought.
Kangaroo turns "go to line" into a dialog-free, keyboard-only flow, adds a jump-back history that survives edits, and ships workspace-wide bookmarks that stick to the code, not to a line number.
- ⌨️ Inline go-to-line: no dialog, just type the number
- 👀 Peek a line: see (and edit) any line in a floating box without leaving your spot
- ↩️ Jump back: return to where you were, even after the file changed
- 🔖 Bookmarks: titled, tracked through edits, saved in
.vscode/, searchable
Keys on macOS: this document uses the Windows/Linux keys. On a Mac, read Ctrl as ⌘ (Command), Alt as ⌥ (Option) and Shift as ⇧. Every table also lists the Mac keys in full.
Inline go-to-line
Press Ctrl+L (macOS: ⌘L) and just start typing digits. The cursor follows you live.
| Key |
macOS |
What it does |
0–9 (also ۰–۹, ٠–٩) |
same |
Jump to that line as you type |
| Backspace |
same |
Delete a digit. When the number is empty you're back where you started |
| ↑ / ↓ |
same |
Previous / next line number |
| ← / → |
same |
Start / end of the line, then leave the mode |
| Enter |
same |
Leave the mode and stay on the line |
| Ctrl+Enter |
⌘Enter |
Insert a line below and start typing there |
| Ctrl+Shift+Enter |
⌘⇧Enter |
Insert a line above and start typing there |
| Esc |
same |
Cancel and return to the original position |
| any other key |
same |
Leave the mode and type that character right there |
Moving the cursor with the mouse or switching editors also leaves the mode.
Peek mode
Press Ctrl+Shift+L (macOS: ⌘⇧L) and type a line number. The line opens in a VS Code peek box while your cursor stays put. All the keys above work here too, with a twist: accepting moves the caret into the peek box, so you can edit the peeked line in place.
- Enter, Ctrl+Enter, Ctrl+Shift+Enter, ←/→ or any character focus the editor inside the box
- Esc closes the box
- ↑ / ↓ flip through neighbouring lines
Jump back
Ctrl+Alt+L (macOS: ⌘⌥L) returns to where you were before your last jump (go-to-line or bookmark). Press it again to keep walking back.
VS Code's own "go back" can lose its place when the file is edited. Kangaroo keeps its own history and moves every saved position with your edits: insert lines above, delete a block, split a line, and the entry still points at the same code.
Bookmarks
| Key |
macOS |
What it does |
| Ctrl+Alt+K |
⌘⌥K |
Add a bookmark on the current line (you pick the title), or remove it if one exists |
| Ctrl+Alt+J |
⌘⌥J |
Search all bookmarks |
In the search list:
| Key |
macOS |
What it does |
| Enter |
same |
Go to the bookmark |
| Ctrl+Enter |
⌘Enter |
Open it in a side editor group |
| Ctrl+Shift+Enter |
⌘⇧Enter |
Peek it (and edit it in place) |
Bookmarked lines get a gutter icon and an overview-ruler mark; hover to see the title. The Kangaroo view in the Activity Bar lists everything grouped by file, with inline rename and delete.
Bookmarks follow the code
A bookmark is tied to its line's content, not its number. Add lines above, press Enter at the start of the line, delete a block elsewhere, and the bookmark moves along. If a file changes outside VS Code (a git pull, another tool), Kangaroo re-finds each bookmark by its text the next time the file opens.
Stored in your workspace
Bookmarks are saved to .vscode/kangaroo-bookmarks.json, with paths relative to the workspace, so you can commit the file and share it with your team:
{
"version": 1,
"bookmarks": [
{ "file": "src/server.js", "line": 42, "title": "Auth entry point", "text": "app.use(authMiddleware);" }
]
}
The file is re-read when it changes on disk, and only written when there is something to save. Without an open folder, bookmarks are kept in VS Code's workspace storage instead.
Installing
Not on the Marketplace, so install it locally.
Build a .vsix (needs Node.js):
npx @vscode/vsce package
code --install-extension kangaroo-0.1.1.vsix
Or copy the folder into your extensions directory and run Developer: Reload Window:
| OS |
Extensions directory |
| Windows |
%USERPROFILE%\.vscode\extensions\bsimjoo.kangaroo-0.1.1 |
| Linux |
~/.vscode/extensions/bsimjoo.kangaroo-0.1.1 |
| macOS |
~/.vscode/extensions/bsimjoo.kangaroo-0.1.1 |
To hack on it, open the folder in VS Code and press F5.
Customising keys
Every shortcut is a normal VS Code keybinding; remap them in Keyboard Shortcuts (search for kangaroo).
Kangaroo's "insert line" keys call VS Code's editor.action.insertLineAfter / insertLineBefore. If you rebind those, rebind kangaroo.acceptInsertAfter / kangaroo.acceptInsertBefore to match.
Kangaroo overrides Ctrl+L (expand line selection) and Ctrl+Shift+L (select all occurrences) inside the editor. Rebind kangaroo.start / kangaroo.peek if you'd rather keep them.
Good to know
- While the go-to-line mode is on, Kangaroo takes over the
type command; it lets go the moment you leave the mode, so it won't fight extensions like Vim.
- Peek focus is handled for you whatever
editor.peekWidgetDefaultFocus is set to.
Development
node test-positions.js # unit tests for the edit-tracking logic
The position tracker lives in positions.js and has no VS Code dependency.
License
Copyright © 2026 BSimjoo bsimjoo@gmail.com
Kangaroo is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License v3.0 as published by the Free Software Foundation. It is distributed in the hope that it will be useful, but without any warranty. See LICENSE for the full text.