Getting started

From install to comfortable daily use

Install from source

git clone https://github.com/JamalYusuf/vim-plus.git
cd vim-plus
npm ci
npm run tsc

Open chrome://extensions
Enable Developer mode
Load unpacked → select the repository root (the folder that contains manifest.json)
Pin the toolbar icon
Under chrome://extensions/shortcuts, assign Open side panel (suggested: Alt+Shift+V)

Reload the extension after every npm run tsc when you change TypeScript sources.

Key	Action
`j` / `k`	Scroll down / up
`h` / `l`	Scroll left / right
`d` / `u`	Half-page down / up
`gg` / `G`	Top / bottom
`f` / `F`	Link hints — current tab / new tab
`o` / `O`	Omnibar — current / new tab
`:`	Command palette
`/`	Find mode
`v`	Visual mode
`?`	Help overlay
`i`	Insert mode (type into the page)
`r`	Reload
`x` / `X`	Close tab / restore closed
`gS`	Side panel command center
`gA`	Window picker (omnibar)
`gn`	Toggle dark UI style (vomnibar + theme)
`Esc`	Cancel / leave insert

Exact bindings depend on your key map. Side panel → Keys lists what is active for the current page.

Navigate pages — scroll with j/k/d/u, jump with gg/G
Follow links — f then type the hint labels
Jump history / URLs — o omnibar; hashbangs like !g cats or !grok summarize this
Power tools — : command palette, or open the side panel
Customize — one mapping at a time in Options → Keys

Content scripts cannot run on most Chrome internal pages (chrome://settings, Web Store, New Tab in many setups). Use:

Test new keys on a normal https:// page first.