Skip to content
| Marketplace
Sign in
Visual Studio Code>Keymaps>VimNinja: Learn Vim (Interactive Tutor)New to Visual Studio Code? Get it now.
VimNinja: Learn Vim (Interactive Tutor)

VimNinja: Learn Vim (Interactive Tutor)

VimNinja

| (0) | Free
Learn Vim in VS Code with an interactive Vim tutor: lessons with a real Vim editor, a two-minute daily review, drills, Vim golf and practice on your own code. Works with VSCodeVim and VSCode Neovim.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

VimNinja: Learn Vim in VS Code

Interactive Vim lessons, a two-minute daily review and Vim golf, right inside VS Code.

Learn Vim's motions where you'll use them. VimNinja brings the course from vimninja.com into VS Code: 82 short lessons with a real Vim editor, a daily review of the commands you're starting to forget, drills on real code, a Vim golf hole a day, and practice on a copy of your own file.

It pairs with VSCodeVim or VSCode Neovim: VimNinja teaches the keys, they bring them to your files.

VS Code with VimNinja open beside a TypeScript file: a lesson round with a real Vim editor, and the XP each command earns

Get started

  1. Install VimNinja (Extensions, Ctrl+Shift+X or Cmd+Shift+X, search VimNinja). In Cursor, Windsurf and VSCodium it's the same search: they install from Open VSX.
  2. Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P) and run VimNinja: Open.
  3. Start the first lesson. No account needed; your progress stays in VS Code.

Look for Learn Vim with VimNinja in VS Code's Get Started (Help › Welcome) for a six-step tour.

What you get

The course in a tab

82 short lessons, from your first keystroke to macros, with a real Vim editor that reads back every key you press. The free chapters are here; the rest open with Pro on vimninja.com.

A VimNinja lesson in VS Code: Fill the gaps, two letters missing from real code, the Vim editor in Normal mode

Today, in two minutes

Each command you learn comes back just as you'd start to forget it: a few questions from memory, then five goals on real code. The ninja in the activity bar shows your streak, what's fading, the next lesson and today's golf hole; the status bar says what's due, and a click opens today's review.

VimNinja's side view: 3 commands are fading with Review now, the next lesson, and today's golf hole

Practise on your own file

VimNinja: Practise Vim on This File opens a copy of the file (or the lines you selected) in VimNinja's editor. Move, change and undo as you like: the file itself is never changed.

orders.ts opened as a copy in VimNinja's editor: Your file, as a copy, 18 keys so far

It feels like VS Code

It wears your colour theme, light or dark, and VS Code's shortcuts keep working: only the keys Vim needs stay in the practice editor.

The same lesson in a light theme

And, when you want them

  • A coach in your own files (optional). Turn it on in VimNinja's Settings (or VimNinja: Coach Me in My Files) and, while you edit with VSCodeVim or VSCode Neovim, VimNinja notices the slow ways (crawling with j or l, x x x, backspacing a word away) and now and then shows the faster one in the status bar: "j × 8 → 8j or }". One tip at most every 10 minutes, each once a day; a click offers the lesson, "got it", or turning it off.
  • Motion hints (optional). In Normal mode, a small letter above where w b e ^ $ would take the cursor, and { } at the paragraph's edges, so the keys you're learning show where they go. The text never moves.
  • Vim Tutor in AI chat (optional). Turn it on and the chat's agent can use VimNinja's Vim Tutor: run keys on your text and show before and after, answer how-tos with the keys, give exercises. Off until you turn it on; when on, the chat's Vim questions go to vimninja.com.
  • Settings worth having. VimNinja's Settings list the changes Vim users in VS Code most often need (the system clipboard for y and p, relative line numbers, jk to leave Insert mode, Vim in its own process, key repeat on a Mac), each with the exact line it puts in your settings. Nothing changes until you press its button, and Undo puts back what was there.
  • Reminders, if you want them. At a time you pick, or when you come back to VS Code after a few hours. At most one a day, and none once today's review is done. Off until you turn them on.

Commands

Command What
VimNinja: Open The course, where you left it
VimNinja: Today's Review (the Daily 5) Two minutes on what's fading
VimNinja: Practise Drills for every command, on real code
VimNinja: Today's Golf Hole One Vim puzzle a day, fewest keystrokes wins
VimNinja: Next Lesson Straight to where the course goes next
VimNinja: Practise Vim on This File A copy of your file (or selection) to practise on
VimNinja: Connect Your Account Optional: sync with the course on vimninja.com
VimNinja: Coach Me in My Files (On/Off) Tips on the slow ways you edit, in the status bar
VimNinja: Motion Hints (On/Off) Where w b e ^ $ { } go, in Normal mode

FAQ

Is VimNinja a Vim emulator? No, it teaches Vim. To use Vim keys in your own files, install VSCodeVim or VSCode Neovim alongside it. VimNinja's Settings tell you which one you have, and the settings worth turning on.

I've never used Vim. Where do I start? Run VimNinja: Open and start with the first lesson, Meet the modes. Each lesson shows an idea, plays it on real code, then hands you the keys.

Is it free? Yes. The free chapters and drills, today's review, Vim golf and practice on your own file need no account and no payment. VimNinja Pro, on vimninja.com, opens the rest of the course and every drill.

Does it work in Cursor, Windsurf or VSCodium? Yes: editors built on VS Code install it from Open VSX. It's tested in VS Code and Cursor.

More on vimninja.com

  • The full Vim course: every lesson, in the browser.
  • Vimtutor online: Vim's own tutor, with a real Vim editor.
  • Vim cheat sheet: the commands on one page.

Privacy

Nothing leaves VS Code until you connect an account. Progress and settings are kept in VS Code's own storage on this computer. If you connect (a code you approve on vimninja.com while signed in), your practice results sync with your account; the sign-in token is kept in VS Code's secret storage and is sent only to vimninja.com. The file you practise on stays on this computer and is never sent anywhere. Disconnect any time, in VimNinja's Settings or on your account page.

Settings

Setting Default
vimninja.statusBar true Show what's due today in the status bar
vimninja.coach false Coach you in your own files (tips in the status bar)
vimninja.aiTutor false Offer VimNinja's Vim Tutor to VS Code's AI chat
vimninja.hints false Show where w b e ^ $ { } go, in Normal mode

Works in VS Code 1.90 and later, and in the editors built on it that install from Open VSX.

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft