Vim Adventure

Who Is Vim Adventure For?

What is Vim and Why Learn It?

Vim (Vi Improved) is a modal text editor created by Bram Moolenaar in 1991, building on the original vi from 1976. Unlike modern editors where every keystroke inserts text, Vim uses distinct modes: Normal mode for navigation and commands, Insert mode for typing, Visual mode for selection, and Command-line mode for ex commands. The radical idea is that editing is not just about typing new text — most development time is spent navigating, selecting, deleting, and rearranging existing code.

Once Vim's motions are internalized, editing reaches a speed that mouse-based editors cannot match. There is no mouse to reach for, no hand-off between keyboard and trackpad, no scanning for the right menu item. The cursor moves exactly where you intend, at the speed you think. Frequent Vim users often describe the experience as "editing at the speed of thought."

Vim is installed by default on virtually every Unix and Linux system, making it universal for anyone who works over SSH, manages servers, or deploys to Linux. Modern adoption has expanded massively: the VS Code Vim extension has tens of millions of installs, Cursor ships with built-in Vim mode, JetBrains IdeaVim covers IntelliJ and WebStorm, and Neovim has become the most popular developer terminal editor. Obsidian, the popular note-taking tool, has a Vim mode. Browser extensions like Vimium bring Vim keybindings to Chrome and Firefox.

Learning Vim is one of the highest-ROI investments a developer can make. You will use it for the rest of your career, on every computer you touch, in every editor that supports it — and most do.

Vim Keys You Will Learn in This Game

Level 1–3 teach the four directional keys: h (left), j (down), k (up), l (right). These replace the arrow keys and keep your hands on the home row at all times. The mnemonic that helps most people: j looks like a down arrow, h is to the left of j, l is to the right.

Level 4–6 introduce word motions: w jumps to the next word start, b to the previous word start, e to the end of the current word, and ge to the end of the previous word. These are faster than pressing l repeatedly for longer distances. 0 moves to the very start of the line, $ to the very end.

Level 7–9 cover larger-scale navigation: gg goes to the top of the file, G to the bottom. { and } jump paragraph by paragraph. H, M, and L move the cursor to the top, middle, and bottom of the visible screen.

Level 10–12 introduce find-character navigation: f{c} jumps forward to the next occurrence of character c on the current line, F{c} searches backward. t{c} moves to just before the character (till), T{c} is the backward equivalent. ; repeats the last find in the same direction, , reverses it.

Level 13–15 cover search: /pattern searches forward through the entire buffer, ?pattern searches backward. n jumps to the next match, N to the previous. * searches for the word under the cursor.

Level 16–18 introduce count prefixes: any number before a motion multiplies it. 5j moves down 5 rows, 3w jumps forward 3 words, 10l moves right 10 characters. This is where Vim navigation starts to feel genuinely fast.

Level 19–21 introduce editing commands: x deletes the character under the cursor, dw deletes from cursor to end of word, d$ deletes to end of line, dd deletes the entire line.

Level 22–24 cover yank and paste (yy copies a line, p pastes it), r{c} replaces the character under the cursor, and u undoes the last change.

Level 25 introduces . (the dot operator) — repeating the last compound action. This is the single most powerful productivity multiplier in Vim. Once you learn to structure your edits so . can replay them, your editing speed multiplies.

Why Play a Vim Game Instead of Reading a Tutorial?

Research in motor learning and cognitive science consistently shows that procedural skills — skills involving physical movements and sequences — are acquired through repetition and immediate feedback, not through reading. Vim is a procedural skill. Reading "press w to move to the next word" creates declarative knowledge. Pressing w two hundred times in a game where it matters, and seeing the cursor land precisely at the next word start, creates the motor memory that makes Vim feel instinctive.

Vim tutorials suffer from a fundamental problem: the learner can read the command, understand it intellectually, and immediately forget it the moment their hands stop forming the motion. Games solve this by forcing you to use the motion to progress. You cannot cheat your way through a level by reading about w — you have to press it.

The game design here uses context-forced learning: the level is structured so that the newly taught key is genuinely the best or only efficient solution. The star rating system (minimum keystrokes for 3 stars) creates an incentive to find the most efficient motion rather than brute-forcing every level with hjkl.

This mirrors how professional Vim users actually practice: through deliberate repetition of specific motions in real editing scenarios. Studies on skill acquisition suggest that 40 hours of deliberate practice builds solid motor memory for complex physical skills. The 25 levels in this game provide approximately 4–8 hours of focused Vim motion practice — enough to make the most common motions automatic.

Using Vim in Real Editors After the Game

Once you have built Vim muscle memory in the game, the same keys work immediately in real editors. Here are the most popular options:

Neovim is the modern Vim fork and the most popular terminal editor among developers. It supports Lua-based configuration, has a rich plugin ecosystem, and is the foundation of many development workflows. If you want to go all-in on Vim, start here.

The VS Code Vim extension (by vscodevim) is the largest-installed Vim plugin with tens of millions of downloads. It brings Vim Normal, Insert, and Visual modes into VS Code with strong compatibility. Most motions from this game work identically in VS Code Vim.

Cursor, the AI-powered code editor, has built-in Vim mode accessible from the settings. Many developers use Cursor for AI assistance with Vim keybindings for speed — a powerful combination.

JetBrains IdeaVim supports IntelliJ IDEA, WebStorm, PyCharm, GoLand, and other JetBrains IDEs. It is highly configurable and supports most Vim motions.

Obsidian Vim mode brings hjkl navigation and Vim commands to your note-taking workflow. Particularly useful for developers who write technical notes in Markdown.

Vimium (Chrome/Firefox extension) brings f-search, hjkl navigation, and search commands to your browser. Press f and every link on the page gets a letter combination — jump to any link without touching the mouse. After this game, you will use it daily.