This Emacs package provides deep, bidirectional integration with the Claude Code CLI, transforming Claude into an Emacs-aware AI coding assistant. It allows Claude to leverage Emacs' extensive features like LSP, Tree-sitter, and custom Elisp functions, offering context-aware assistance within the user's existing workflow.

How It Works

The package implements the Model Context Protocol (MCP) to bridge Emacs and Claude. It exposes Emacs capabilities as MCP tools, enabling Claude to understand project structure, code context, and even execute arbitrary Emacs commands. This approach allows Claude to go beyond simple text generation and actively interact with the Emacs environment for tasks like code navigation, refactoring, and diagnostics.

Quick Start & Requirements

• Install: Use straight.el with use-package (see README for configuration).
• Prerequisites: Emacs 28.1+, Claude Code CLI installed and in PATH, vterm or eat package.
• Setup: Requires installing the Claude Code CLI separately.

Highlighted Details

• Bidirectional integration via MCP protocol.
• Leverages Emacs features: LSP, Tree-sitter, project.el, ediff.
• Supports diagnostics via Flycheck/Flymake.
• Automatic project detection and multi-project session management.
• Extensible MCP tools server for custom Emacs command exposure.

Maintenance & Community

• Actively maintained by Yoav Orot.
• Related to Claude Code CLI and other IDE integrations.

Licensing & Compatibility

• Licensed under GNU General Public License v3.0 or later.
• GPLv3 license may have implications for use in closed-source commercial projects due to copyleft provisions.

Limitations & Caveats

The package is in early development. It relies on the Claude Code CLI, which must be installed and configured separately. Some features, like terminal reflow glitch prevention, are temporary workarounds for upstream issues.