PRJ-instrumentum-nvim: Neovim Development Configuration

1. Project Summary

Field Value

PRJ ID

PRJ-2025-TOOL-002

Date Created

~2025

Owner

Evan Rosado

Priority

P2 (Active tool)

Category

Developer Tooling / Neovim Configuration

Status

Active (v1.2.0)

Commits

10

Repository

github.com/EvanusModestus/instrumentum-nvim (private)

Local Path

~/atelier/_projects/personal/instrumentum-nvim

2. Purpose

Instrumentum (Latin: tool, instrument) is a production-ready Neovim configuration focused on development productivity. It provides a modular, symlink-based setup that works cross-platform (Linux, WSL, Windows, Termux/Android).

Built for a network engineer transitioning to DevOps, it emphasizes Python automation, network device scripting (Netmiko, REST APIs), Jinja2 template support, and comprehensive language server integration across 14+ languages.

3. Scope

3.1. Core Features

  • LSP Integration: Full language server support with auto-completion (14+ languages)

  • Formatting: Auto-format on save via conform.nvim (Black, Prettier, StyLua, shfmt)

  • Linting: Async linting with nvim-lint (pylint, flake8, ruff, ESLint, shellcheck)

  • Git Integration: Fugitive + Gitsigns

  • File Navigation: Telescope, Harpoon, Oil

  • Debugging: DAP integration for Python, Rust, C/C++, JavaScript

  • Session Management: Auto-restore sessions and layouts

3.2. Network Engineer Features

  • 15+ Python snippets for Netmiko, REST APIs, CLI tools

  • Interactive REPL via iron.nvim

  • REST API client with .http file support

  • Jinja2 LSP + syntax for Ansible templates

  • Cisco config syntax highlighting

3.3. Module Architecture

Module Contents

core/

Settings, keymaps, autocmds, MOTD sections (arsenal picker, CLI tips, fzf, todo counter)

lsp/

Language server configurations

plugins/

27 plugin configurations (auto-session, telescope, harpoon, diffview, toggleterm, which-key, etc.)

dap/

Debug adapter configurations per language (Python, Rust, C++, JavaScript)

ui/

Lualine statusline, visual enhancements, Catppuccin Mocha theme

3.4. Language Support

Python, TypeScript, JavaScript, Lua, Rust, Go, C/C++, Bash, SQL, JSON, YAML, Markdown, Jinja2, AsciiDoc

4. Status

Aspect Status

Version

1.2.0

Min Neovim

0.10.0+

Active Use

Daily driver — primary editor configuration

Maintenance

Ongoing (plugin updates, new language support)

4.1. Relationship to domus-nvim

domus-nvim is the AsciiDoc-focused Neovim configuration for documentation work. instrumentum-nvim is the general-purpose development configuration. They coexist via symlink switching:

# Switch between configs
rm ~/.config/nvim && ln -s ~/atelier/_projects/personal/instrumentum-nvim ~/.config/nvim
rm ~/.config/nvim && ln -s ~/atelier/_projects/personal/domus-nvim ~/.config/nvim

5. Related

6. Metadata

Field Value

PRJ ID

PRJ-2025-TOOL-002

Author

Evan Rosado

Date Created

~2025

Last Updated

2026-03-30

Status

Active (v1.2.0)

Next Review

2026-04-15