NEO.ED

June 29, 2026 · View on GitHub

███╗   ██╗███████╗ ██████╗    ███████╗██████╗
████╗  ██║██╔════╝██╔═══██╗   ██╔════╝██╔══██╗
██╔██╗ ██║█████╗  ██║   ██║   █████╗  ██║  ██║
██║╚██╗██║██╔══╝  ██║   ██║   ██╔══╝  ██║  ██║
██║ ╚████║███████╗╚██████╔╝██╗███████╗██████╔╝
╚═╝  ╚═══╝╚══════╝ ╚═════╝ ╚═╝╚══════╝╚═════╝

NEO.ED

Note

EdHeltzel's Neovim Configuration

My personal Neovim configuration, based on LazyVim - optimized for web development and used as my ADE (AI/Agent Development Environment) of choice.

Features

LazyVim Foundation: Built on LazyVim for a solid, well-maintained base
AI Integration: Claude Code, Pi, and OMP
Multi-Language: JavaScript/TypeScript, Go, Python, PHP/WordPress, Rust, and more
Vite+ Formatting & Linting: vp fmt (Oxfmt) on save, live Oxlint LSP diagnostics
Custom Theme: Eldritch colorscheme with custom lualine statusline

Screenshots

Quick Start
Architecture
Plugin Categories
Keybindings Reference
Language Support
Configuration Guide
Workflows

Quick Start

Prerequisites

Neovim >= 0.10.0
Git
A Nerd Font (for icons)
Node.js (for LSP servers)
Ripgrep (for search)

Installation

Choose one of the two install paths below.

Option 1: Standalone (recommended)

Install NEO.ED directly as your Neovim configuration — no dotfiles or Stow required.

# 1. Back up any existing Neovim configuration and state
mv ~/.config/nvim ~/.config/nvim.bak 2>/dev/null
mv ~/.local/share/nvim ~/.local/share/nvim.bak 2>/dev/null
mv ~/.local/state/nvim ~/.local/state/nvim.bak 2>/dev/null
mv ~/.cache/nvim ~/.cache/nvim.bak 2>/dev/null

# 2. Clone NEO.ED into your Neovim config directory
git clone https://github.com/edheltzel/neoed ~/.config/nvim

# 3. (Optional) Remove the upstream git history so you can version it as your own
rm -rf ~/.config/nvim/.git

# 4. Launch Neovim — Lazy.nvim will install plugins on first run
nvim

To update later (if you kept the .git directory):

cd ~/.config/nvim && git pull

Option 2: Via Dotfiles (my personal setup)

NEO.ED is also available as a submodule inside my Dotfiles repo, managed with GNU Stow. Use this path if you want my full macOS setup (fish shell, Homebrew, app configs, etc.).

# Clone the dotfiles repository
git clone --recurse-submodules https://github.com/edheltzel/dotfiles ~/.dotfiles

# Stow the neoed package
cd ~/.dotfiles
just stow neoed

# Or manually
stow -v neoed

First Launch

Open Neovim: nvim
Lazy.nvim will automatically install all plugins
Run :Mason to install LSP servers and formatters
Run :LazyExtras to enable additional language packs

Architecture

Directory Structure

lua/
├── config/              # Core configuration
│   ├── lazy.lua        # Plugin manager bootstrap
│   ├── options.lua     # Vim options
│   ├── keymaps.lua     # Custom keybindings
│   ├── autocmds.lua    # Autocommands
│   └── filetypes.lua   # Custom filetype associations
│
└── plugins/             # Plugin configurations
    ├── disabled.lua    # Disabled plugins (neo-tree)
    │
    ├── ai/             # AI assistants
    │   ├── claudecode.lua
    │   ├── omp-agent.lua
    │   └── pi-agent.lua
    │
    ├── coding/         # Code editing
    │   ├── emmet.lua
    │   └── surround.lua
    │
    ├── editor/         # Editor enhancements
    │   ├── flash.lua
    │   ├── git.lua
    │   ├── multicursor.lua
    │   ├── obsidian.lua
    │   └── treesitter.lua
    │
    ├── formatting/     # Code formatters
    │   ├── align.lua
    │   └── viteplus.lua  # vp fmt (Oxfmt) via conform
    │
    ├── languages/      # Language-specific configs
    │   ├── astro.lua
    │   ├── docker.lua
    │   ├── ghostty.lua
    │   ├── go.lua
    │   ├── jinja.lua
    │   ├── markdown.lua
    │   ├── php.lua           # PHP/WordPress (phpactor)
    │   ├── python.lua
    │   ├── tailwind.lua
    │   └── typescript.lua
    │
    ├── ui/             # UI customization
    │   ├── colorscheme.lua
    │   ├── lualine.lua
    │   ├── noice.lua
    │   ├── treesitter-context.lua
    │   └── lualine/          # Statusline themes
    │       ├── neoed.lua         # Theme adapter
    │       ├── aura.lua
    │       ├── eldritch.lua
    │       ├── rose-pine.lua
    │       └── tokyonight.lua
    │
    └── utils/          # Snacks.nvim utilities
        ├── snacks-dashboard.lua
        ├── snacks-image.lua
        ├── snacks-notifier.lua
        ├── snacks-persistence.lua
        ├── snacks-picker.lua
        └── snacks-projects.lua   # Project manager (like VSCode)

Plugin Load Order

init.lua - Entry point, loads config.lazy
config/lazy.lua - Bootstraps lazy.nvim, loads filetypes
LazyVim base plugins load
Custom plugin specs load (in directory import order)
config/options.lua - Vim options
config/keymaps.lua - Keybindings (VeryLazy)
config/autocmds.lua - Autocommands (VeryLazy)

Plugin Categories

AI Assistants

Plugin	Description	Key Binding
claudecode.nvim	Claude Code integration	`<D-C-c>`
pi.nvim	Pi integration	`<D-C-p>`
OMP	OMP terminal agent	`<D-C-o>`

Floating window (80% width/height)
Rounded border
Floating terminal is exposed through Snacks with rounded borders and editor keymaps

Claude Code Configuration (lua/plugins/ai/claudecode.lua):

Floating window (80% width/height)
Rounded border
--dangerously-skip-permissions mode enabled

Editor Enhancements

Plugin	Description	Key Bindings
multicursor.nvim	Multiple cursors	`<C-S-l>`, `<C-A-down/up>`
gitsigns.nvim	Git integration	Current line blame enabled
flash.nvim	Motion plugin	`<leader>jj`

Formatting Stack

Formatting (from lua/plugins/formatting/viteplus.lua):

Vite+ vp fmt (Oxfmt) — primary for JS/TS/JSX/TSX/JSON/JSONC/CSS/SCSS/LESS/HTML/Markdown/GraphQL/Vue/Svelte
Astro language server — .astro (Oxfmt does not support astro)

Linting: Oxlint LSP (live, as-you-type) + vtsls for TypeScript type diagnostics. Biome and ESLint LSPs are disabled. Commit-time format/lint runs via the Vite+ staged hook (vp check --fix).

UI Components

Component	Plugin	Configuration
Colorscheme	eldritch.nvim	Dark theme with dim inactive
Statusline	lualine.nvim	Custom NEO.ED theme
File Explorer	snacks.explorer	Right sidebar, hidden files
Picker	snacks.picker	Default layout
Dashboard	snacks.dashboard	Custom NEO.ED header
Terminal	snacks.terminal	Borderless float
Projects	snacks.projects	Project manager (like VSCode)

ai.claudecode - Claude Code integration
ai.pi - Pi integration
omp-agent.lua - OMP terminal integration

Coding:

coding.mini-surround - Surround text objects
dap.core - Debug adapter protocol

Editor:

editor.mini-files - File browser
editor.snacks_explorer - Snacks file explorer
editor.snacks_picker - Snacks picker

Formatting:

formatting.viteplus - Vite+ vp fmt (Oxfmt) via conform; Oxlint LSP for linting

Languages:

lang.astro - Astro
lang.docker - Docker/Compose
lang.go - Go
lang.json - JSON
lang.markdown - Markdown
lang.php - PHP
lang.python - Python
lang.rust - Rust
lang.svelte - Svelte
lang.tailwind - Tailwind CSS
lang.toml - TOML
lang.typescript - TypeScript
lang.vue - Vue
lang.yaml - YAML

Utilities:

util.dot - Dotfile support
util.mini-hipatterns - Pattern highlighting

Language-Specific Features

Go (`lua/plugins/languages/go.lua`)

LSP: gopls with enhanced settings

gofumpt formatting
Inlay hints (parameters, types, values)
Static analysis (nilness, unused params/writes)
Semantic tokens

Testing: neotest-golang

Python (`lua/plugins/languages/python.lua`)

LSP: Pyright + Ruff

Pyright for type checking
Ruff for linting (replaces ESLint behavior)

DAP: debugpy integration

Virtual Environments: venv-selector.nvim

TypeScript (`lua/plugins/languages/typescript.lua`)

LSP: vtsls (not tsserver)

Complete function calls
Auto-update imports on file move
Inlay hints
Move to file refactoring

DAP: js-debug-adapter

Custom Icons: eslintrc, package.json, tsconfig, etc.

PHP/WordPress (`lua/plugins/languages/php.lua`)

LSP: phpactor

Blade template support
WordPress development optimized
Diagnostics disabled (no "function not found" errors)

Formatter: phpcbf with WordPress coding standards

DAP: php-debug-adapter

WordPress Setup: For WordPress projects, add php-stubs/wordpress-stubs via Composer and create a .phpactor.json:

{
  "php_code_sniffer.enabled": false,
  "language_server_worse_reflection.diagnostics.enable": false,
  "indexer.stub_paths": ["%project_root%/vendor/php-stubs/wordpress-stubs"]
}

Configuration Guide

Vim Options (`lua/config/options.lua`)

-- Terminal Background Sync (OSC 11/111)
-- Eliminates padding gap by syncing terminal bg with colorscheme
-- Works with: WezTerm, Kitty, Ghostty, Alacritty

-- UI
opt.cursorline = true       -- Highlight current line
opt.cursorcolumn = true     -- Highlight current column
opt.scrolloff = 999         -- Keep cursor centered
opt.wrap = true             -- Wrap long lines

-- Files
opt.swapfile = false        -- No swap files
opt.backup = false          -- No backup files
opt.undofile = true         -- Persistent undo

-- Timing
o.timeoutlen = 250          -- Key sequence timeout

-- Platform
g.codeium_arch = "arm64"
g.codeium_os = "Darwin"

Custom Filetypes (`lua/config/filetypes.lua`)

Extension/Pattern	Filetype
`.njk`	htmldjango
`.webc`	htmldjango
`.conf`	sh
`*.blade.php`	blade
`*.svg`	html

Autocommands (`lua/config/autocmds.lua`)

YAML Frontmatter: Enables YAML syntax in template files
Help Windows: Opens help in vertical split
Auto Resize: Equalizes splits on window resize
No Auto Comment: Disables automatic comment continuation
Dotenv Syntax: Highlights .env files as dosini

Theme Configuration

Colorscheme: Eldritch (lua/plugins/ui/eldritch.lua)

Transparent: false
Dim inactive: true
Dark sidebars and floats
Custom background: #171928

Statusline: Custom lualine theme (lua/plugins/ui/lualine/neoed.lua)

Centered filename
Mode indicator (left and right)
Project directory
Git branch and diff
Diagnostics
Macro recording indicator

Workflows

Daily Development

Start Neovim - Dashboard shows recent files, dotfiles shortcuts
Open Project - Use <leader>fp to browse projects (scans ~/Developer and ~/Sites)
Find Files - Use <leader>ff for file picker
Navigate Files - Use Snacks explorer (right sidebar)
Edit with Multi-Cursor - <C-n> for next match
Format on Save - Vite+ (Oxfmt via vp fmt) automatically formats

Project Management

The snacks-projects module works similarly to VSCode's Project Manager extension:

Press <leader>fp to open the project picker
Scans ~/Developer and ~/Sites for git repositories (up to 4 levels deep)
Selecting a project loads its session automatically
Configure additional directories in lua/plugins/utils/snacks-projects.lua

Git Workflow

Open Lazygit: <leader>gg
Open GitHub Dash: <leader>gh (rounded floating terminal)
View inline blame (automatic via gitsigns)
Stage changes in Lazygit
Commit with conventional messages

Debugging (DAP)

Set breakpoints
Start debug session with language-specific commands
Use DAP UI for inspection

AI-Assisted Coding

Toggle Claude Code: <D-C-c>
Floating window appears (80% size)
Ask questions or request code changes
Claude Code can read/modify files directly

Troubleshooting

Plugin Issues

:Lazy          " Open plugin manager
:Lazy sync     " Sync plugins
:Lazy health   " Check plugin health

LSP Issues

:LspInfo       " Check LSP status
:LspLog        " View LSP logs
:Mason         " Manage LSP servers

Performance

:LazyProfile   " Profile startup time

Reload Configuration

:source %      " Reload current file
" Or restart Neovim

Changelog

v1.1.0 (2026-06-24)

Vite+ replaces Biome for JS/TS

Formatting: vp fmt (Oxfmt) via conform on save, for JS/TS/JSX/TSX/JSON/CSS/HTML/Markdown/GraphQL/Vue/Svelte. Invoked by absolute path (~/.vite-plus/bin/vp) with --stdin-filepath; no-ops outside a Vite+ workspace.
Linting: live Oxlint language server diagnostics (replaces Biome/ESLint, which are disabled). vtsls retained for TypeScript type info.
oxfmt LSP disabled — formatting flows through vp fmt instead.
<leader>v Vite+ commands — dev/check/lint/fmt/test/build/preview/run/install + a command picker.
Pre-commit: Vite+ staged hook (vp check --fix) replaces the Biome pre-commit story.
Astro: Oxfmt has no .astro support, so the astro LSP handles astro formatting.

v1.0.0 (2026-02-03)

First stable release

Terminal Background Sync: OSC 11/111 integration eliminates padding gaps in WezTerm, Kitty, Ghostty, Alacritty
Theme Support: Eldritch (default), Aura, Rose Pine, Tokyo Night, Base16 (Atelier Cave/Lakeside)
AI Integration: Claude Code, Pi, and OMP with floating windows
Project Management: VSCode-style project picker scanning ~/Developer and ~/Sites
Modular Snacks: Dashboard, explorer, picker, notifier, persistence split into individual configs
Custom Lualine: Colorscheme-adaptive statusline with mode indicators

License

Part of the dotfiles repository. See main repository for license information.