• Mac: You will to want to use a terminal that supports Truecolor, like:
  • Alacritty
  • Extraterm

git clone --recurse-submodules git://github.com/tecfu/.vim ~/.vim

. ~/.vim/INSTALL.sh

Why use coc.nvim?

• coc-snippets allows you to use VSCode snippets with vim
• coc.nvim language server ease of install

• List all installed extensions

:CocList extensions

• Access coc-settings.json

:CocConfig

This configuration supports multiple, isolated coc.nvim profiles. Each profile has its own coc-settings.json and extensions.json, located in ~/.vim/coc-profiles/<profile_name>/.

The active profile is determined by the COC_PROFILE environment variable. If it's not set, it defaults to default.

Switching Profiles:

To use a different profile for a single session, set the COC_PROFILE environment variable when launching Neovim. For example, to use a profile named efm:

COC_PROFILE=efm nvim

To make a profile the default for all sessions, you can export the variable in your shell's startup file (e.g., ~/.bashrc, ~/.zshrc):

export COC_PROFILE=efm

Creating a New Profile:

1. Create a directory for your new profile:

   mkdir -p ~/.vim/coc-profiles/my-new-profile

2. Add a coc-settings.json to that directory.
3. Add an extensions.json to that directory to define the CoC extensions for that profile.

• Add the following to ~.config/nvim/init.vim:

set runtimepath^=~/.vim runtimepath+=~/.vim/after
let &packpath = &runtimepath
source ~/.vimrc

• Install pynvim

On Ubuntu and derivatives you will need to install python-distutils

Example for python3.11

sudo apt install python3.11-distutils

You may need to install a new version of pip (>23.1.2) before installing pynvim

pip3 install pynvim

A key feature of this setup is its use of efm-langserver for diagnostics and formatting, managed by a custom wrapper script. This provides an intelligent, project-aware linting system.

How it works: The installer symlinks a generic wrapper script (efm-langserver-linter-wrapper.sh) that intelligently decides which configuration to use for a given linter:

1. If a project-local configuration file exists (e.g., eslint.config.js in your project root), the wrapper will use it. This ensures project-specific rules are always respected.
2. If no local configuration is found, the wrapper falls back to a personal, default configuration located in your home directory (e.g., ~/.config/eslint/). This ensures even miscellaneous files are linted consistently.

The installer automatically symlinks:

• efm-langserver-config.yaml -> ~/.config/efm-langserver/config.yaml
• efm-langserver-linter-wrapper.sh -> ~/.config/efm-langserver/efm-langserver-linter-wrapper.sh

For the fallback mechanism to work, you must create the personal default configurations.

For ESLint (JavaScript, JSON, Markdown code blocks):

# Create a dedicated directory
mkdir -p ~/.config/eslint
cd ~/.config/eslint

# Initialize it as a self-contained Node.js project
npm init -y

# Install the necessary parsers and plugins locally
npm i -D eslint-plugin-jsonc jsonc-eslint-parser eslint-plugin-markdown

# Now, create your fallback ~/.config/eslint/eslint.config.js

For Markdownlint (Markdown prose):

mkdir -p ~/.config/markdownlint
# Create your fallback config file (e.g., to enable all default rules)
touch ~/.config/markdownlint/config.json

• i.e.: Ubuntu Mono derivative Powerline

sudo apt-get install fonts-powerline

sudo -S apt-get install silversearcher-ag

• This .vimrc uses junegunn/vim-plug to manage plugin installation. You can add new plugins by appending them to the file: .vimrc.plugins .

• Once you have added a new plugin, you can auto-generate a tabular brief summary in the README.md file by running a npm script that does this for you:

npm run update-plugin-list

• CoC can't install plugins when a npm registry is private

npm config set registry https://registry.npmjs.org

• Vim onedark https://github.com/joshdick/onedark.vim

• Neovim (Mac) dracula https://github.com/dracula/vim

• Neovim (Other) tokyonight https://github.com/folke/tokyonight.nvim

This project is my personal vimrc. Feel free to send me suggestions through the issues page or to send me improvements through the pull requestspage.

• If some characters do not render correctly

Make sure you install powerline fonts