My Emacs Config

Personal Emacs configuration using Elpaca package manager with a modular architecture.

Installation

git clone https://github.com/vshender/.emacs.d ~/.emacs.d

On first launch, Elpaca will automatically install all required packages.

Dependencies

Tools

• fd - Fast file finder. Used for quickly locating files in projects.

• ripgrep - Fast recursive search tool. Used by consult-ripgrep for project-wide text search and by the MCP ripgrep server for LLM-assisted code search.

• dasel - JSON/YAML/TOML query tool. Used by pet to parse Python project config files (pyproject.toml, etc.) for virtual environment detection.

• jq - JSON processor. Used by jq-mode for interactive JSON filtering.

• pandoc - Universal document converter. Used by markdown-mode for document preview and export.

• libnotify (Linux) / terminal-notifier (macOS) - Desktop notification tools. Used by alert for sending desktop notifications (e.g., pomodoro timer events). Install via sudo pacman -S libnotify (Arch), sudo apt install libnotify-bin (Debian/Ubuntu), or brew install terminal-notifier (macOS).

Language Servers

• basedpyright - Python language server. Provides code completion, diagnostics, and navigation for Python via eglot. Can be installed in the project's virtual environment.

• vscode-json-languageserver - JSON language server. Provides schema validation, completion, and diagnostics for JSON/JSONC files.

• yaml-language-server - YAML language server. Provides schema validation, completion, and diagnostics for YAML files.

Linters

• ruff - Fast Python linter and formatter. Used by flymake-ruff for real-time Python linting. Can be installed in the project's virtual environment.

LLM Configuration

gptel requires API keys for the configured backends. See gptel documentation for more details.