Learn Practice Daily golf Reference

VimNinja for VS CodeFree

Learn Vim without leaving VS Code.

82 short lessons, a two-minute daily review and Vim golf in a tab beside your code. Practice on a copy of your own file. And, when you turn it on, a coach that spots slow habits as you edit with VSCodeVim or VSCode Neovim.

Free, from the Visual Studio Marketplace, for VS Code 1.90 or later. Cursor, Windsurf and VSCodium: on Open VSX next. Already learning here? Connect it and your progress comes with you.

VS Code with orders.ts on the left and VimNinja’s tab on the right, playing today’s review on a copy of the code; the status bar shows -- NORMAL -- and 3 to review · 7 days
A real capture: VimNinja beside your code, in VS Code’s Dark Modern.

In your files: a coach, and where each motion goes.

Both are off until you turn them on. Crawl with j or delete letter by letter, pause, and the tip shows in the status bar. Rest the cursor and small letters mark where w b e ^ $ would take you. This is the extension’s own code, on a real Vim engine.

5 qty: number;
6}
7
8const TAX_RATE = 0.0825;
9
10export function subtotal(lines: OrderLine[]): number {
11 lete swum = 0;$
12 for (const line of lines) sum += line.item.price * line.qty;
13 return sum;
14}
15
16export function total(lines: OrderLine[], tip = 0): number {
17 const base = subtotal(lines);
18 const tax = Math.round(base * TAX_RATE * 100) / 100;
⎇ main⊗ 0 ⚠ 0-- NORMAL --Ln 11, Col 3Spaces: 2TypeScript3 to review · 7 days

Rest the cursor in Normal mode: a letter marks where w b e ^ $ would go, and { } the paragraph’s edges. Nothing in the line moves.

In VS Code a tip comes at most every 10 minutes, each one at most once a day. Here, every time, so you can see them.

The whole course, in a tab.

Real captures of the extension in VS Code.

A VimNinja lesson in a VS Code tab: Six ways into Insert mode, Fill the gaps, a hint over the gap

Lessons beside your code

82 short lessons, from your first keystroke to macros. Where VS Code’s Vim works differently, the lesson says so.

Practise Vim on This File: a copy of orders.ts in the course’s editor, subtotal renamed to itemsTotal in 18 keys; the file itself is never changed

Practise on your own file

Practise Vim on This File opens the file you’re in as a copy, every key read back. Change it, undo it, try again. Your file never changes.

VimNinja’s side bar view beside orders.ts: 3 commands are fading, b e w, with Review now, the next lesson and today’s golf hole

Two minutes a day keeps it

Each command comes back just as you’d start to forget it. The status bar counts what’s due; the side bar shows today at a glance.

The lesson in VS Code’s Dark Modern theme The same lesson in VS Code’s Light Modern theme

It wears your theme

Your colours and font, light or dark.

Vim in VS Code, set up right.

Settings › Vim in VS Code knows which Vim you have and offers the settings worth having. Each shows the line it writes before you press it, and Undo puts the old value back.

settings.json
// what VimNinja writes, one line per fix
"vim.useSystemClipboard": true
"editor.lineNumbers": "relative"
"vim.insertModeKeyBindings": [ …yours, { "before": ["j", "k"], "after": ["<Esc>"] } ]
"extensions.experimental.affinity": { …yours, "vscodevim.vim": 1 }
// in Terminal, on a Mac (then restart VS Code)
defaults write com.microsoft.VSCode ApplePressAndHoldEnabled -bool false

Nothing changes until you press a button.

Everything is a command away.

Every part of it is in the command palette, ready for a keybinding of your own. Type to look.

  • VimNinja: Open
  • VimNinja: Today's Review (the Daily 5)
  • VimNinja: Practise
  • VimNinja: Today's Golf Hole
  • VimNinja: Next Lesson
  • VimNinja: Practise Vim on This File
  • VimNinja: Connect Your Account
  • VimNinja: Coach Me in My Files (On/Off)
  • VimNinja: The Last Tip
  • VimNinja: Settings Worth Having (Vim in VS Code)
  • VimNinja: Tip from Neovim
  • VimNinja: Motion Hints (On/Off)
  • VimNinja: Vim Tutor in AI Chat (On/Off)

Your editor, your Vim

One extension for VS Code and the editors built on it, with whichever Vim you use.

  • VS Code Version 1.90 or later. Its Get Started page walks you through VimNinja, a step at a time.
  • Cursor The same extension, the same course. Checked in Cursor, connecting an account included.
  • Windsurf and VSCodium Editors built on VS Code get it from Open VSX, as they get their other extensions.
  • VSCodeVim The coach reads what VS Code sees: the cursor stepping, text going one character at a time.
  • VSCode Neovim The coach runs inside your Neovim and sees every key, exactly; its tips come to VS Code’s status bar.
  • No Vim yet The course needs nothing installed: lessons run in VimNinja’s own Vim. Settings › Vim in VS Code helps you pick one.

With VS Code’s AI chat, VimNinja can also offer its Vim Tutor: it runs Vim keys on your text in a real engine and answers Vim how-tos. Off until you turn it on.

One course, wherever you practise.

Connect the extension to your vimninja.com account and they become one: your results and reviews sync both ways, and Pro opens in VS Code too. It’s optional, and until you connect, nothing leaves VS Code.

  1. Start here, now. The course, the daily review and golf, free, in your browser.
  2. Add the extension. From the Visual Studio Marketplace; Open VSX, for Cursor, Windsurf and VSCodium, is next.
  3. Connect, once. A short code you approve here, and your progress is in VS Code.

Your code stays yours.

  • No network requests until you connect an account
  • Your file is practised as a copy, never changed
  • No setting changes without your click
  • No telemetry, no ads
  • An account’s key kept in VS Code’s secret storage

Connected, it sends your practice to your account (your results, your reviews, the exercises you finish) and nothing else from VS Code: never a file, never a file’s name. The privacy policy

Questions

Something else? Ask us. We read everything.

How do I install it?

In VS Code, open Extensions (Ctrl+Shift+X, or Cmd+Shift+X on a Mac), search for VimNinja and press Install, or install it from the Visual Studio Marketplace. Cursor, Windsurf and VSCodium install from Open VSX, where it goes next. Already learning on vimninja.com? Connect the extension and everything you’ve done comes with you.

Is it free?

Yes. The extension is free, with the free lessons, the daily review, practice drills and golf. Pro, on vimninja.com, opens every lesson’s exercises and every drill, there and in VS Code once your account is connected.

Do I need VSCodeVim or VSCode Neovim?

Not to learn: the lessons run in VimNinja’s own Vim, inside the tab. To use what you learn in your files, yes, and Settings › Vim in VS Code says which you have and what’s worth setting.

Will it change my files or my settings?

No. Your file is practised as a copy; the file itself is never touched. A setting changes only when you press its button in the Vim doctor, after reading the line it writes, and Undo puts the old value back.

Will it nag me?

The coach and the motion hints are off until you turn them on. On, a tip comes at most every ten minutes, each at most once a day, and “got it” means never again.

Does it work with my theme?

Yes. VimNinja’s tab takes your theme’s colours and font, light or dark. The code editor in it keeps the course’s own colours, as a code block does.

Does it send what I type anywhere?

No. The coach keeps only how often each habit was seen. Until you connect an account, the extension makes no network request; connected, it sends your practice to your account, never a file. The Vim Tutor in AI chat is off until you turn it on, and says what it sends when you do.

I use Neovim in a terminal too.

There’s VimNinja for Neovim, coming at the same time: the same coach and practice, in plain Lua.

Learn Vim
where you write code.

Free. VS Code 1.90 or later; Cursor, Windsurf and VSCodium from Open VSX next.