coc-vscode-loader

coc-vscode-loader

AOT (Ahead-of-Time) converter: install VS Code extensions and convert them to coc.nvim plugins at install time.

Install/update/uninstall converted VS Code extensions via a terminal UI. Supports Neovim 0.8+ (floating window + extmark) and Vim 9.0+ (split window + text properties).

⚠️ IMPORTANT: Keep Updated Each release includes critical converter fixes. Outdated versions silently produce broken plugins. After updating, the loader auto-detects which plugins changed — look for [changed] markers in the TUI and reinstall only those. Run :CocCommand loader.open → check for [changed] markers → press R on marked plugins.

All 134 upstream VS Code repos are monitored daily for API-breaking changes. When detected, automated PRs are created for review — so your plugins stay working.

Install

:CocInstall coc-vscode-loader

Or via npm:

cd ~/.config/coc/extensions
npm install coc-vscode-loader

TUI Keymaps

Key	Action
I	Install mode (button highlight)
U	Update all installed packages (max 3 concurrent)
C	Check for remote updates (git ls-remote commit compare)

| H | Home (reset all state) | | ? | Help | | i | Install package under cursor | | u | Update package under cursor | | X | Uninstall package under cursor | | R | Reinstall package under cursor | | f | Cycle filter: all → installed → available | | s | Cycle sort: default → name → status → type | | j / k | Scroll through packages (virtual scroll) | | gg | Jump to first package | | G | Jump to last package | | <CR> | Open detail popup (info / install log with syntax highlights) | | / | Search filter | | q | Close (auto :CocRestart if changes detected) | | <Esc> | Language filter→Search→Close |

Global Extensions (auto-install)

Define extensions to auto-install on plugin activation via vim variable:

" .vimrc
let g:coc_loader_global_extensions = ['vscode-pyright', 'vscode-eslint', 'vscode-lua']

-- init.lua
vim.g.coc_loader_global_extensions = { 'vscode-pyright', 'vscode-eslint', 'vscode-lua' }

On next :CocRestart, the plugin will fetch the registry and install any missing extensions concurrently (max 3 at a time). Installed extensions are skipped.

Features

• Real conversion pipeline — git clone → converter → npm install → esbuild → register to coc
• Source-compiled servers — pipeline auto-installs Go servers via go install (goPackages) and Rust servers via cargo install (cargoPackages), binaries go to server/ directory
• Binary server download — auto-downloads pre-built server binaries from GitHub Releases (.zip, .tar.gz, .gz)
• Pre-built VSIX server — auto-downloads & extracts compiled server from VS Code marketplace for kind: "module" servers that need compilation (TypeScript, wasm, etc.)
• Local server build — auto-copies server/ directory from source, installs deps, compiles TypeScript during build
• Pip install — auto-installs Python packages via pip for plugins that need them (e.g. ansible-lint)
• Auto-fetch registry — remote registry fetched in background when TUI opens, no manual refresh needed
• Virtual scrolling — j/k smooth scroll through packages, handles 100k+ registry entries
• Incremental cache — source/ keeps git repo, updates via git fetch + reset
• Commit tracking — records commit SHA after install, visible in detail view
• Update check — C key compares against remote HEAD, shows ↑ when outdated
• Cross-version impact — :CocCommand loader.whatChanged compares baseline between versions, shows which installed plugins need reinstall
• Auto restart — :CocRestart triggered automatically on close when changes detected
• Manual registry update — :CocCommand loader.updateRegistry also available for re-fetch
• Detail popup — <CR> opens centered float window with package info or live install log (syntax highlighted, auto-scroll to latest)
• Filter & sort — f cycle view filter, s cycle sort order (name/status/type)
• Concurrency limit — max 3 parallel operations for U (Update All)
• Desktop notifications — showInformationMessage on install/update/uninstall complete
• Auto-check updates — silent check on startup, notifies only when updates found
• Cross-version change detection — on startup after upgrade, silently detects which installed plugins' output files changed, marks them [changed] in TUI, and notifies the user
• Cache cleanup — :CocCommand loader.cleanCache removes build artifacts
• Export package list — :CocCommand loader.list copies installed package names to clipboard

Architecture

File	Description
src/index.ts	Plugin entry + 11 CocCommands
src/tui.ts	TUI window management + rendering + key dispatch
src/state.ts	State management (debounced rendering)
src/registry.ts	Remote registry fetch + disk cache
src/pipeline.ts	Real install/update/uninstall flow (git + npx tsx + npm + node + cp). Handles local servers (copies server/ dir, installs deps), binary server download, Go/Cargo source-compiled servers, pip install.
src/renderer.ts	LineBuffer render engine (inspired by lazy.nvim)
src/editor-api.ts	Editor abstraction interface
src/nvim-editor.ts	Neovim backend (float window + extmark)
src/vim-editor.ts	Vim backend (split window + text properties)
src/editor-factory.ts	Auto-detects has('nvim') → picks the right backend

Build

npm install
npm run build    # esbuild → lib/index.js

Test

Integration tests use coc-test, which starts Vim/Neovim with coc.nvim and the activated extension:

npm test              # Neovim (default)
npm run test:vim      # Vim
npm run test:watch    # watch mode