A game interface of your git commands.

gcmds is a cli layer on top of git. Type commit and it opens a 3D shooter in your browser — clear the level and it runs the real command. Die and lose work.

zsh
$ npm install -g git-commandos
$ gcmds commit -m "lets go"

01 / WATCH IT

See a run

03 / COMMANDS

Install and run

install
$ npm install -g git-commandos

Needs Node 18.17+ and a real git on your PATH. Ships pre-built — nothing to compile after install.

Commands

CommandDescription
gcmds commit -m "message"Commit staged files — survive to ship them
gcmds quick-runStage fake files and play a test round
gcmds fake-files [--count=N]Create and stage N fake .ts files
gcmds playLaunch sandbox mode — no real git state

All commands accept --extreme: on loss, files are deleted from disk instead of just unstaged.

Everything else — status, log, push, whatever — goes straight to the real git, unmodified. Alias git=gcmds in your shell if you want it everywhere; git itself is never installed over or replaced, and \git skips the game on any single command.

Controls

WASDMove
MouseAim
Left mouseFire
SpaceDodge
EInteract — deposit or reclaim at the stash cache
QDrop a crate
RReload
EscPause

Gamepad works too — sticks to move and aim, triggers to fire.

Pickups

Machine Gun / ShotgunWeapon upgrade — the Sidearm never runs out, these do
AmmoRounds for the matching weapon only
MedkitHeal, under the health rule

04 / COMING SOON

More ways to lose work

Commit ships today. The rest of the git surface is still in the briefing room — unchecked, untested, and coming for your repo.

  • gcmds merge <branch> Merge a branch
  • gcmds rebase oh god no
  • gcmds pull Fetch and hope
  • gcmds push Ship commits to remote

05 / FAQ

Frequently asked, honestly answered

Is this a good idea?
No.
Is it safe to use on a real project?
No.
I lost a bunch of work. What do I do?
Please fill out this form.