emacs-claude-code

🥈Silver

@ywatanabe1989

Emacs interface for Claude Code with auto-response, vterm integration, and session management. Enables developers to interact with Claude Code directly within Emacs, automating code generation and terminal tasks. Connects to Claude Code API and integrates with vterm for workflow.

1920Updated 4mo ago

Intermediate30min to implementautomation

Saves ~30 min per use

Quick InstallView Source

git clone https://github.com/ywatanabe1989/emacs-claude-code.git

Works with:

Claude

Overview

About This Skill

emacs-claude-code provides an Emacs interface for Claude Code and Codex CLI with automatic prompt handling, detecting and responding to Y/N and Y/Y/N permission dialogs without manual intervention. It integrates vterm for terminal workflows and suppresses auto-responses when users are actively typing, preventing unwanted automation. The skill includes state detection (running, waiting, suggestion), a centralized buffer dashboard showing timer status and debug logs, audio notifications with beep tones and TTS alerts, and a yank-as-file feature for efficiently handling large content. Developers get watchdog protection against stuck states, periodic command queuing, and tab highlighting to visualize Claude buffer status in real-time.

How to Use

Clone the repository to ~/.emacs.d/lisp/emacs-claude-code and add (require 'emacs-claude-code) to your init.el. Use M-x ecc-list-buffers to view the dashboard, M-x ecc-auto-toggle to enable auto-response for your vterm buffer, and M-x ecc-vterm-yank-as-file to send clipboard content as a file. Configure response mappings and periodic commands in your init.el if needed.

Use Cases

Automate repetitive Y/N prompts during long-running Claude Code sessions

Monitor multiple Claude Code vterm buffers simultaneously via dashboard

Keep sessions active with periodic `/speak` commands and `/compact` cycles

Transfer large code snippets to remote hosts via yank-as-file without terminal clutter

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/ywatanabe1989/emacs-claude-code

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

I'm a developer working on [PROJECT] for [COMPANY]. I need help with [TASK] in [PROGRAMMING_LANGUAGE]. Can you provide code snippets, explain concepts, or debug issues? I'm using Emacs with the Claude Code integration. Here's the relevant code: [CODE_SNIPPET].

Example Output

```lisp
;; Emacs Lisp configuration for Claude Code integration

;; Enable Claude Code mode
(setq claude-code-api-key "your-api-key-here")
(setq claude-code-model "claude-2")

;; Auto-response configuration
(setq claude-code-auto-response t)
(setq claude-code-auto-response-delay 1)

;; Vterm integration
(require 'vterm)
(setq claude-code-vterm-integration t)

;; Session management
(defun claude-code-start-session ()
  (interactive)
  (claude-code-new-session "default"))

;; Keybindings
(global-set-key (kbd "C-c c c") 'claude-code-start-session)
(global-set-key (kbd "C-c c r") 'claude-code-auto-response-toggle)
```

## Features
- **Auto-response**: Automatically generates code responses based on context
- **Vterm Integration**: Seamless terminal interaction within Emacs
- **Session Management**: Save and restore Claude Code sessions

## Usage
1. Set your API key in the configuration
2. Enable auto-response for your preferred delay
3. Use keybindings to start sessions and toggle features