im | `.` | yes | \_function_call | like `function args` but only when a function is called | outer includes the function called | | `ih`, `ah` | vscode-neovim | `.` | yes | \_html_attribute | attribute in html/xml like `href="foobar.com"` | inner is only the value inside the quotes trailing comma and space | | `ii`, `ai` | | `.` | | indent_noblanks | surrounding lines with same or higher indentation delimited by blanklines | outer includes line above | | `iI`, `aI` | vscode-neovim | `.` | | indent | surrounding lines with same or higher indentation | outer includes line above and below | | `ik`, `ak` | vscode-neovim | `.` | yes | \_key | key of key-value pair, or left side of a assignment | outer includes spaces | | `il`, `al` | vscode-neovim | `.` | yes | +last | go to last mini.ai text-object (which start with `_`) | requires `i`/`a` example `vilk` | | `im`, `am` | vscode-neovim | `.` | yes | \_number | numbers, similar to `` | inner: only pure digits, outer: number including minus sign and decimal point | | `in`, `an` | vscode-neovim | `.` | yes | +next | go to Next mini.ai text-object (which start with `_`) | requires `i`/`a` example `viNk` | | `io`, `ao` | vscode-neovim | `.` | yes | \_whitespaces | whitespace beetween characters | outer includes surroundings | | `ip`, `ap` | | `.` | | paragraph | blanklines can also be treat as paragraphs when focused on a blankline | outer includes below lines | | `iq`, `aq` | | `.` | yes | \_quotes | inside of `` ` ` `` or `' '` or `" "` | outer includes openning and closing quotes | | `is`, `as` | | `.` | | sentence | sentence delimited by dots of blanklines `:help sentence` | outer includes spaces | | `it`, `at` | | `.` | yes | \_tag | inside of a html/jsx tag | outer includes openning and closing tags | | `iu`, `au` | vscode-neovim | `.` | | \_subword | like `iw`, but treating `-`, `_`, and `.` as word delimiters _and_ only part of camelCase | outer includes trailing `_`,`-`, or space | | `iv`, `av` | vscode-neovim | `.` | yes | \_value | value of key-value pair, or right side of a assignment | outer includes trailing commas or semicolons or spaces | | `iw`, `aw` | | `.` | | word | from cursor to end of word (delimited by punctuation or space) | outer includes whitespace ending | | `iW`, `aW` | | `.` | | WORD | from cursor to end of WORD (includes punctuation) | outer includes whitespace ending | | `ix`, `ax` | vscode-neovim | `.` | yes | \_Hex | hexadecimal number or color | outer includes hash `#` | | `iy`, `ay` | vscode-neovim | `.` | | same_indent | surrounding lines with only same indent (delimited by blankspaces or commented lines) | outer includes blankspaces | | `i?`, `a?` | vscode-neovim | `.` | yes | \_user_prompt | will ask you for enter the delimiters of a text object (useful for dot repeteability) | outer includes surroundings | | `i(`, `i)`, `a(`, `a)` | | `.` | yes | `(` or `)` | inside `()` | outer includes surroundings | | `i[`, `i]`, `a[`, `a]` | | `.` | yes | `[` or `]` | inside `[]` | outer includes surroundings | | `i{`, `i}`, `a{`, `a}` | | `.` | yes | `{` or `}` | inside `{}` | outer includes surroundings | | `i<`, `i>`, `a<`, `a>` | | `.` | yes | `<` or `>` | inside `<>` | outer includes surroundings | | `` i` ``, `` a` `` | | `.` | yes | apostrophe | inside `` ` ` `` | outer includes surroundings | | `i`, `a` | vscode-neovim | `.` | yes | `` | inside `` | outer includes surroundings | ## Neovim text-object/motions that starts with `g`

| text-object keymap | requires | mode | repeat action key | repeat jump key | text-object description | normal mode | operating-pending mode | visual mode | examples in normal mode | | :----------------: | :------------ | :---------: | :---------------: | :--------------------: | :------------------------------------------------------------------------ | :--------------------------------------- | :--------------------- | :--------------------------- | :--------------------------------------------------------------------------- | | `g<`/`g>` | vscode-neovim | `n`,`o`,`x` | `.` | | prev/next find | text-object not required | finds and jumps | uses selection | `cg>???` replaces last search with `???` forwardly | | `g;`/`g,` | | `n` | | | go backward/forward in `:changes` | jumps | | | `g;` go to last change | | `g.` | vscode-neovim | `n`,`o`,`x` | | | jump to last change | jumps | won't jump | uses selection | `vg.` selects from cursor position until last change | | `ga` | vscode-neovim | `n`,`x` | | | +align | followed by textobject/motion | | uses selected region | `gaip=` or `vipga=` aligns a paragraph by `=` | | `gb` | vscode-neovim | `n`,`x` | `.` | | +blackhole register | followed by textobject/motion | | deletes selection | `gbip` or `vipgb` deletes a paragraph without copying | | `gB` | vscode-neovim | `n`,`x` | `.` | | blackhole linewise | text-object not required | | deletes line | `gB.` deletes two lines without saving it in the register | | `gc` | | `n`,`o`,`x` | `.` | | +comment (`vgc` in normal mode will select a block comment) | followed by textobject/motion | won't jump | uses selection | `gcip` or `vipgc` comments a paragraph | | `gC` | vscode-neovim | `n`,`o`,`x` | `.` | | block comment (supports selection `vgC` or just `gC`) | select text-object under cursor | won't jump | reselects | `vgC` selects current block of comment | | `gd` | | `n` | | | go to definition | jumps | | | `gd` go to definition of word under cursor | | `gD` | vscode-neovim | `x` | | | git diff/hunk (vscode selects from cursor position to end of diff) | | won't jump | reselects | `vgD` selects modified code | | `ge`/`gE` | | `n`,`o`,`x` | | | previous end of word/WORD (`WORD` omits punctuation) | jumps | uses cursor position | uses selection | `vge` selects from cursor position until previous end of word | | `gf` | | `n`,`x` | | | go to file under cursor | jumps | | uses selection | `gf` open in a tab the path under cursor | | `gg`/`G` | | `n`,`o`,`x` | `.` | | first/last line | jumps | uses cursor position | uses selection | `vgg` selects until first line | | `gi` | | `n`,`x` | | | last position of cursor in insert mode | finds and jumps | | uses selection | `vgi` selects until last insertion | | `gj`/`gk` | | `n`,`o`,`x` | `.` | | go down/up when wrapped | jumps | uses cursor position | uses selection | `vgj` selects one line down | | `gJ` | | `n`,`x` | `.` | | join below lines | joins | | uses selection | `vgJ` joins selected lines into one line | | `gm` | vscode-neovim | `n`,`x` | | | +multiply (duplicate text) operator | | won't jump | uses selection | `gnap` or `vapgm` duplicates paragraph without replacing clipboard | | `gM` | | `n`,`x` | | | go to middle line | jumps | | uses selection | `vgM` selects until middle of the line | | `gp`/`gn` | vscode-neovim | `n`,`o`,`x` | `.` | `;`forward `,`backward | +prev/+next textobj (only textobj with `_` prefix) | finds and jumps | followed by textobject | uses selection | `vgniq` selects from cursor position until next quotation | | `gpc` / `gnc` | vscode-neovim | `n`,`o`,`x` | `.` | `;`forward `,`backward | previous/next comment | finds and jumps | jumps | uses selection | `vgnc` selects from cursor position until next comment | | `gpd` / `gnd` | vscode-neovim | `n`,`o`,`x` | `.` | `;`forward `,`backward | previous/next diagnostic | finds and jumps | jumps | uses selection | `vgnd` selects from cursor position until next diagnostic | | `gpf` / `gnf` | neovim | `n`,`o`,`x` | `.` | `;`forward `,`backward | previous/next fold (only inside neovim) | finds and jumps | jumps | uses selection | `vgnf` selects from cursor position until next fold | | `gpH` / `gnH` | vscode-neovim | `n`,`o`,`x` | `.` | `;`forward `,`backward | previous/next git hunk | finds and jumps | jumps | uses selection | `vgnH` selects from cursor position until next git hunk | | `gpr` / `gnr` | vscode-neovim | `n`,`o`,`x` | `.` | `;`forward `,`backward | previous/next reference (only inside vscode) | finds and jumps | jumps | uses selection | `vgnr` selects from cursor position until next reference | | `go` | neovim | `x` | | | jsx/tsx comment (only inside neovim) | | | uses selection | `vipgo` comments out a paragraph with `{/* */}` | | `gq` | | `n`,`x` | `.` | | +format selection/comments 80chars (LSP overrides it) | requires a textobject | | applies to selection | `gqip` or `vipgq` formats a paragraph | | `gr` | vscode-neovim | `n`,`x` | `.` | | +replace (with register) operator | followed by text-object/motion | | applies to selection | `griw` or `viwgr` replaces word with register (yanked text) | | `gs` | vscode-neovim | `n`,`x` | `.` | | +sort Operator | followed by text-object/motion | | uses selection | `gsip` or `vipgs` sorts a paragraph | | `gS` | vscode-neovim | `n`,`x` | `.` | | split/join arguments | toggles inside `{}`,`[]`,`()` | | followed by operator | `vipgS` joins selected lines in one line | | `gt`/`gT` | vscode-neovim | `n`,`x` | `.` | `;`ending `,`beginning | +go to end/start of textobj | followed by text-object | | selects form cursor position | `vgtiq` selects until end of quotation | | `gu`/`gU` | | `n`,`x` | `.` | | +to lowercase/uppercase | requires a text-object | | applies to selection | `gUiw` (neovim only) or `viwgU` lowercases a word | | `gv` | | `n`,`x` | | | last selected | finds and jumps | | reselects | `vgv` selects last selection | | `gw` | | `n`,`x` | `.` | | split/join comments/lines 80chars (keeps cursor position) | requires a text-object | | applies to selection | `gwip` or `vipgw` split/join a paragraph limited by 80 characters | | `gx` | vscode-neovim | `n`,`x` | `.` | | +exchange (text) Operator | followed by text-object/motion | | uses selection | `gxiw` or `viwgx` exchanges word with another `gxiw` or `viwgx` or `.` | | `gy`/`gY` | vscode-neovim | `n` | `.` | | redo register (dot to paste forward/bacward) | paste | | | `gy.....` paste deleted lines by history | | `g-`/`g+` | vscode-neovim | `n`,`x` | `.` | | decrement/increment number | selects number under cursor | | uses selected number | `g+..` or `3g+` increments by 3 | | `g`/`g` | vscode-neovim | `n`,`x` | | | numbers ascending/descending | selects number under cursor | | uses selected number | `g` increases selected numbers ascendingly | | `=` | | `n`,`x` | `.` | | +autoindent | followed by text-object | | uses selection | `==` autoindents line | | `<`/`>` | | `n`,`x` | `.` | | +indent left/right | followed by text-object | | uses selection | `<<` indents to left a line | | `0`/`$` | | `n`,`o`,`x` | `.` | | start/end of line | jumps | | uses selection | `d$j.` deletes two end-of-lines | | `^` | | `n`,`o`,`x` | `.` | | start of line (non-blankline) | jumps | | uses selection | `d^` deletes until start of line (after whitespace) | | `%` | | `n`,`o`,`x` | | | matching character: '()', '{}', '[]' | finds and jumps | | finds and jumps | `d%` deletes until bracket | | `(`/`)` | | `n`,`o`,`x` | `.` | | prev/next sentence | jumps | | uses selection | `d(.` deletes until start of sentence (two times) | | `{`/`}` | | `n`,`o`,`x` | `.` | | prev/next empty line (before a paragraph) | jumps | | uses selection | `d{.` deletes until next empty line (two times) | | `[[`/`]]` | | `n`,`o`,`x` | `.` | | prev/next section | jumps | | uses selection | `d[[` deletes until start of section | | `b`/`w` | | `n`,`o`,`x` | `.` | | prev/next word | jumps | | uses selection | `db` deletes until start of word | | `B`/`W` | | `n`,`o`,`x` | `.` | | prev/next WORD | jumps | | uses selection | `dW.` deletes 2 WORDS | | `e`/`E` | | `n`,`o`,`x` | `.` | | end of word/WORD | jumps | | uses selection | `de` deletes until end of word | | `f` | cvim | `n`,`o`,`x` | `.` | | search with labels like [flash.nvim](https://github.com/folke/flash.nvim) | jumps | | uses selection | `f???` then press the label | | `f`/`F` | | `n`,`o`,`x` | `.` | `;`forward `,`backward | move to next/prev char (`f` to repeat_jump on vscode-neovim) | jumps | | uses selection | `df,` deletes until a next `,` | | `t`/`T` | | `n`,`o`,`x` | `.` | `;`forward `,`backward | move before next/prev char (`f` to repeat_jump on vscode-neovim) | jumps | | uses selection | `dt,` deletes before next `,` | | `s` | | `o` | `.` | | surround (only on vscodevim) | | uses cursor position | | `ysiw"` or `viwS"` adds `"` to word, `ds"` deletes `"`, `cs"'` replaces `"` | | `s` | vscode-neovim | `n`,`x` | `.` | | +surround (followed by a=add, d=delete, r=replace) | followed by textobject/motion (only add) | | uses selection (only add) | `saiw"` or `viwsa"` adds `"` to word, `sd"` deletes `"`, `sr"'` replaces `"` | | `U` | neovim | `n`,`x` | | `U` | whichkey.repeatMostRecent (inside neovim repeats `:`) | | | | `gjUUUUU` repeats go to next git-change | | `Y` | | `n`,`x` | | | yank until end of line | | | uses selection | `v^Y` yanks line | | `p` | vscode-neovim | `n`,`x` | `.` | | Paste after (secondary clipboard) | | | uses selection | `viwp` replaces word with a second clipboard | | `P` | vscode-neovim | `n`,`x` | `.` | | Paste before (secondary clipboard) | | | uses selection | `viwP` replaces word with a second clipboard | | `y` | vscode-neovim | `n`,`x` | | | yank (secondary clipboard) | | | uses selection | `viwy` yanks word using the second clipboard | | `Y` | vscode-neovim | `n`,`x` | | | yank until end of line (secondary clipboard) | | | uses selection | `vY` yanks until end of line using the second clipboard |

## Native neovim ctrl keys

## File Explorer keymaps

## Editor keymaps (keybindings.json)

## Suggestion keymaps

| Key Combination | mode | Description | | :----------------: | :--: | :--------------------------------------------------------------------- | | `ctrl+space` | `i` | Toggle suggestion widget | | `ctrl+shift+space` | `i` | Toggle suggestion details (when inside widget) | | `ctrl+shift+space` | `i` | Toggle parameter hints (when inside parameters) | | `ctrl+h` | `i` | Toggle suggestion focus (when inside widget) | | `ctrl+d` | `i` | Select next page (when inside suggestion details) | | `ctrl+u` | `i` | Select prev page (when inside suggestion details) | | `ctrl+j` | `i` | Select next suggestion | | `ctrl+k` | `i` | Select prev suggestion | | `ctrl+l` | `i` | Accept selected suggestion | | `ctrl+i` | `i` | prompt to AI (gemini/windsurf/copilot) | | `ctrl+k` | `i` | prompt to AI (cursor) | | `ctrl+.` | `i` | fix error with AI (windsurf/cursor/copilot) | | `alt+]` | `i` | Show next inline suggestion | | `alt+[` | `i` | Show previous inline suggestion | | `alt+j` | `i` | inline suggestion accept next word | | `alt+k` | `i` | inline suggestion accept next line | | `alt+l` | `i` | Commit inline/NES suggestion (TRAE/AMP/gemini/windsurf/cursor/copilot) | | `alt+;` | `i` | trigger Next Edit Suggestion (`alt+l` to accept) | | `alt+;` | `i` | accept next edit suggestion (neovim only) | | `escape` | `i` | cancel next edit suggestion | | `tab` | `i` | go to next snippet stop or next suggestion | | `shift+tab` | `i` | go to prev snippet stop or prev suggestion | | `alt+n` | `i` | go to next snippet stop | | `alt+p` | `i` | go to prev snippet stop | | `alt+.` | `i` | expand snippet (neovim only) | | `ctrl+c` | `i` | exit snippet session (neovim only) |

## Terminal keymaps

--- ## zsh/powershell keymaps

--- ## If Touchcursor Keyboard Layout Started

--- ## Installation

- RECOMENDED: On Windows 10/11 to allow creations of symlinks (npm creates them) you need to enable `Developer Mode` Go to `Settings` > `System` > `For Developers` > `Developer Mode` > `On`

- RetroNvim installs [`cvim` a vscodevim fork with flash.nvim support](https://github.com/VSCodeVim/Vim/issues/8567) and [`whichkey` a menu for keymaps](https://github.com/vspacecode/vscode-which-key) vscode extensions as optional dependencies - some text-objects requires install [`vscode-neovim`](https://github.com/vscode-neovim/vscode-neovim) (tested on vscode-neovim version v1.18.17, neovim version v0.11.0 and retronvim version v0.3.0, future versions may be incompatible with retronvim's [init.lua](https://github.com/YeferYV/RetroNvim/blob/main/nvim/init.lua) file) and uninstall/disable [`cvim`](https://github.com/VSCodeVim/Vim/issues/8567) extension, you may need to relaunch vscode, alternatively use `nvim` or `yazi` when opening a terminal with the profile `zsh (retronvim)` or `powershell(retronvim)` which are the default profile when opening a terminal - nvim/yazi/zsh/powershell will search for retronvim installation path alphabetically (~/.cursor then ~/.vscode then ~/.windsurf ...) and will use the first one found **Manual Install** - Linux/MacOS: ```bash curl -L pixi.sh/install.sh | bash source ~/.zshrc pixi global install git nodejs nvim yazi git clone --recursive https://github.com/yeferyv/retronvim cd retronvim npx vsce package --out retronvim.vsix code --install-extension retronvim.vsix ``` - Windows 10/11: ```powershell winget install gnuwin32.file git.git neovim.neovim openjs.nodejs prefix-dev.pixi sxyazi.yazi microsoft.vcredist.2015+.x64 # microsoft.visualstudiocode # then relaunch terminal git clone --recursive https://github.com/yeferyv/retronvim cd retronvim npx vsce package --out retronvim.vsix code --install-extension retronvim.vsix ``` **Install Retronvim on any terminal or ssh** - Linux/Macos/Msys2: ```bash code --install-extension yeferyv.retronvim cp ~/.vscode/extensions/yeferyv.retronvim*/zsh/.zshrc ~/.zshrc ``` - SSH: ```bash curl -s https://api.github.com/repos/yeferyv/retronvim/releases/latest | grep --only-matching --extended-regexp "https.*linux.*vsix" | curl -o retronvim.vsix -L @- unzip retronvim.vsix -d /tmp mkdir -p ~/.vscode/extensions/yeferyv.retronvim cp -r /tmp/extension/* ~/.vscode/extensions/yeferyv.retronvim cp -r /tmp/extension/zsh/.zshrc ~/.zshrc ``` - Windows 10/11: ```powershell set-executionpolicy bypass currentuser ################################################ allow to load profile.ps1 winget install vscode ################################################################ then relaunch terminal code --install-extension yeferyv.retronvim cp -r ~/.vscode/extensions/yeferyv.retronvim*/powershell ~/documents/windowspowershell ``` **Install from github releases (offline)(portable)** open command palette `ctrl+shift+p` then type `Extensions: install from vsix`. **VSCode Marketplace** - RetroNvim extension is shipped with [`neovim`](https://neovim.io), [`kanata`](https://github.com/jtroo/kanata), [`pixi`](https://github.com/prefix-dev/pixi), [`bat`](https://github.com/sharkdp/bat), [`eza`](https://github.com/eza-community/eza), [`fzf`](https://github.com/junegunn/fzf), [`git`](https://github.com/git-for-windows/git), [`lazygit`](https://github.com/jesseduffield/lazygit), [`ripgrep`](https://github.com/BurntSushi/ripgrep), [`starship`](https://github.com/starship/starship), [`yazi`](https://github.com/sxyazi/yazi), [`7zip`](https://github.com/ip7z/7zip) binaries [using github-actions](https://github.com/YeferYV/retronvim/tree/main/.github/workflows/release.yml); and [`mini.nvim`](https://github.com/echasnovski/mini.nvim), [`snacks.nvim`](https://github.com/folke/snacks.nvim), [`zsh-autosuggestions`](https://github.com/zsh-users/zsh-autosuggestions), [`zsh-fast-syntax-highlighting`](https://github.com/zdharma-continuum/fast-syntax-highlighting) as git-submodules; and [`firacode_nerd_font`](https://github.com/ryanoasis/nerd-fonts) for terminal icons - Retronvim/nvim comes with an installer for [neocodeium](https://github.com/monkoose/neocodeium) (free copilot/windsurf), [sidekick.nvim](https://github.com/folke/sidekick.nvim) (gemini cli), [copilot-lsp](https://github.com/copilotlsp-nvim/copilot-lsp) (copilot-nes) and LSP + formatters for: `astro`, `angular`, `bash`, `biome`, `black`, `c`, `c++`, `c#`, `cmake`, `css`, `docker`, `emmet`, `go`, `html`, `php`, `java`, `javascript`, `json`, `lua`, `markdown`, `prisma`, `python`, `prettier`, `rust`, `sql`, `svelte`, `tailwind`, `toml`, `terraform`, `typescript`, `react`, `vue`, `yaml` - Retronvim/nvim searches for `~/.*/extensions/*/snippets/*code-snippets` (alphabetically first `~/.cursor` otherwise `~/.vscode` otherwise `~/.windsurf`) and adds them to `mini.completion` - Retronvim comes with [bat's base16](https://github.com/sharkdp/bat/blob/master/assets/themes/base16.tmTheme) syntax highlighting generated by `npx yo code --extensionType colortheme` and a editor theme generated using https://themes.vscode.one - https://marketplace.visualstudio.com/items?itemName=YeferYV.retronvim

## Trobleshotting

- remove the `~/.vscode/extensions/yeferyv.retronvim` symlink and relaunch vscode - remove `vscode-neovim.neovimExecutablePaths.linux` `vscode-neovim.neovimExecutablePaths.win32` `vscode-neovim.neovimExecutablePaths.darwin` from `settings.json` and relaunch vscode - remove `terminal.integrated.env.linux` `terminal.integrated.env.osx` `terminal.integrated.env.windows` from `settings.json` and relaunch vscode - open vscode command palette and type: `Output: Show Output Channels` > `vscode-neovim logs`

## Package Manager (optional)

- open `whichkey > +Install Dependencies > install brew` for macos or `whichkey > +Install Dependencies > install nix-env` for linux or `whichkey > +Install Dependencies > install scoop` for windows or just use `pixi` if you don't need GUI programs

## Vim Cheatsheets / Tutorials

- [devhints.io/vim](https://devhints.io/vim) most used vim keys - [viemu.com](http://www.viemu.com/a_vi_vim_graphical_cheat_sheet_tutorial.html) vim keys from A-Z - [vscode with embedded neovim](https://www.youtube.com/watch?v=g4dXZ0RQWdw) youtube tutorial most of the keybindings are similar to RetroNvim - [treesitter text-objects demo](https://www.youtube.com/watch?v=FuYQ7M73bC0) youtube tutorial the keybindings are similar to RetroNvim - [treesitter text-objects extended](https://www.youtube.com/watch?v=CEMPq_r8UYQ) youtube tutorial the keybindings are similar to RetroNvim - [text-objects from A-Z](https://www.youtube.com/watch?v=JnD9Uro_oqc) youtube tutorial the keybindings are similar to RetroNvim - [motion-operators from A-Z](https://www.youtube.com/watch?v=HhZJ1kbzkj0) youtube tutorial the keybindings are the same as to RetroNvim

## Related projects

- [yeferyv/dotfiles](https://github.com/yeferyv/dotfiles) retronvim + [hyprland](https://hypr.land) setup - [yeferyv/sixelrice](https://github.com/yeferyv/sixelrice) appimages containing retronvim's kanata, nvim, yazi and zsh configs - [lunarkeymap](https://github.com/fathulfahmy/lunarkeymap) comes with [vscodevim](https://github.com/vscodevim/vim) extension which has some text objects + whichkey with [lunarvim](https://github.com/lunarvim/lunarvim)-like keymaps - [vspacecode](https://github.com/vspacecode/vspacecode) comes with [vscodevim](https://github.com/vscodevim/vim) extension which has some text objects + whichkey with [spacemacs](https://github.com/syl20bnr/spacemacs)-like keymaps - [leaderKey](https://github.com/JimmyZJX/leaderkey) (a faster whichkey with ripgrep/fzf integration) whichkey with [spacemacs](https://github.com/syl20bnr/spacemacs)-like keymaps

�A �Eo��