Public | Automated Build

Last pushed: 3 years ago
Short Description
Run vimgolf in Docker
Full Description Client

Real Vim ninjas count every keystroke - do you? Head on over to, pick a challenge, and show us what you've got!

  • Each challenge provides an input file, and an output file
  • Your goal is to modify the input file such that it matches the output
  • Once you install the vimgolf CLI, pick a challenge, open a prompt and put away!

When you launch a challenge from the command line, it will be downloaded from the site and a local Vim session will be launched, which will log every keystroke you make. Once you're done, simply :wq (write and quit) the session and we will score your input and upload it back to the site!

Setup & Play

$> gem install vimgolf

(Go to, sign in, and grab your API key)
$> vimgolf setup 

(Pick a challenge on
$> vimgolf put [challenge ID]

Setup & Play (Docker)

On a machine with Docker installed

$> docker run --rm -it -e "key=[vimgolf key]" kramos/vimgolf [challenge ID]

Emacs: yes, it is true, you can play vimgolf in emacs too!

Patches, tips and ideas are welcome!


(MIT License) - Copyright (c) 2010 Ilya Grigorik

Docker Pull Command
Source Repository