3 KiB
Quick Start
Five minutes from zero to a working Vim setup.
Install
curl -fsSL https://raw.githubusercontent.com/m1ngsama/chopsticks/main/get.sh | bash
curl -fsSL https://raw.githubusercontent.com/m1ngsama/chopsticks/main/get.sh | bash -s -- --profile=minimal
curl -fsSL https://raw.githubusercontent.com/m1ngsama/chopsticks/main/get.sh | bash -s -- --dry-run --profile=full
Open vim. First launch auto-installs plugins — wait 30-60s, don't close vim. Restart when done.
Default profile is engineer. Interactive installs ask for a profile first;
--profile=minimal, --profile=engineer, or --profile=full selects it
without prompting. You can later put let g:chopsticks_profile = 'minimal' in
${XDG_CONFIG_HOME:-~/.config}/chopsticks.vim for a smaller core-only setup,
or use full for the heavier Markdown/LSP feedback.
To switch later without reinstalling anything:
cd ~/.vim && ./install.sh --configure-only --profile=full
Modes
| Mode | Enter | Leave |
|---|---|---|
| Normal | startup default | — |
| Insert | i / a / o |
Esc or jk |
| Visual | v / V |
Esc |
Survival
Esc / jk back to Normal
,w save
,x save + quit
:q! force quit
Ctrl+s save from any mode
,? cheat sheet (toggle sidebar)
Find things
Ctrl+p fuzzy find file (git-aware)
,rg ripgrep project
,b search buffers
,fh recent files
,e file browser
,, last file
Write code
gd go to definition
K hover docs
,rn rename symbol
,ca code action
,f format
,cr run current file
Tab / S-Tab cycle completions
First time in a new language? Run :LspInstallServer — it auto-detects filetype and installs the right server. Do this once per language.
Git
,gs status (s=stage, cc=commit)
,gd diff
,gb blame
,gp push
]x / [x conflict markers
Edit
,S + 2 chars EasyMotion jump
gc toggle comment
cs"' change surrounding " to '
Alt+j / Alt+k move line
,u undo tree
,y clipboard yank
Navigate
Ctrl+h/j/k/l splits + tmux panes
,h / ,l prev / next buffer
,z maximize window
,tv / ,th terminal
Markdown
,mp preview in browser
,mt table of contents
Markdown is quiet by default: no real-time lint, no spell noise, no concealed syntax. Enable the heavier Markdown tools only when you want them.
Health check
:ChopsticksStatus see what's installed and what's missing
The ,? cheat sheet follows your active profile, so minimal users only see
keys for features that are actually loaded.
See README for the full reference. See the wiki for deep dives.