vimlm 0.0.4

VimLM - LLM-powered Vim assistant

VimLM - Vim Language Model Assistant for privacy-conscious developers

An LLM-powered coding companion for Vim, inspired by GitHub Copilot/Cursor. Integrates contextual code understanding, summarization, and AI assistance directly into your Vim workflow.

Features

• Real-Time Interaction with local LLMs: Runs fully offline with local models (default: uncensored Llama-3.2-3B).
• Integration with Vim's Native Workflow: Simple Vim keybindings for quick access and split-window interface for non-intrusive responses.
• Context-Awareness Beyond Single Files: Inline support for external documents and project files for richer, more informed responses.
• Conversational AI Assistance: Goes beyond simple code suggestions-explains reasoning, provides alternative solutions, and allows interactive follow-ups.
• Versatile Use Cases: Not just for coding-use it for documentation lookup, general Q&A, or even casual (uncensored) conversations.

Installation

pip install vimlm

Usage

1. Start Vim with VimLM:

vimlm

or

vimlm your_file.js

2. From Normal Mode:

   • Ctrl-l: Send current line + file context
   • Example prompt: "Regex for removing html tags in item.content"

3. From Visual Mode:

   • Select text → Ctrl-l: Send selection + file context
   • Example prompt: "Convert this to async/await syntax"

4. Add Context: Use !@#$ to include additional files/folders:

   • !@#$ (no path): Current folder
   • !@#$ ~/scrap/jph00/hypermedia-applications.summ.md: Specific folder
   • !@#$ ~/wtm/utils.py: Specific file
   • Example prompt: "AJAX-ify this app !@#$ ~/scrap/jph00/hypermedia-applications.summ.md"

5. Follow-Up: After initial response:

   • Ctrl-r: Continue thread
   • Example follow-up: "In Manifest V3"

Key Bindings

Binding	Mode	Action
Ctrl-l	Normal/Visual	Send current file + selection to LLM
Ctrl-r	Normal	Continue conversation
Esc	Prompt	Cancel input