emacs-claude-code

Emacs Claude Code

Emacs interface for Claude Code and Codex CLI with intelligent auto-response and enhanced vterm integration.

Supports both Claude Code (❯ prompt) and Codex (› prompt) out of the box.

Key Features

- Auto-Response - Automatically responds to CLI prompts (Y/N, Y/Y/N, Waiting states) for both Claude Code and Codex
- User-Typing Detection - Suppresses all auto-responses while you are actively typing at the prompt
- Accumulation Guard - Prevents duplicate command queuing via buffer-content analysis
- Periodic Auto-Response - Sends periodic commands based on number of interactions
- Buffer Dashboard - Centralized dashboard with timer status, config, state duration, and live debug log
- Audio Notifications - Async beep tones (400Hz heartbeat / 1400Hz sent), pre-recorded TTS, cooldown debounce
- Watchdog - Stuck-state detection with auto re-send; sending guard with timeout; timer lifecycle management
- Speaking Flash - Mode-line flashes green when Claude is speaking via TTS (MCP audio)
- Tab Highlight - Tab-bar tabs pulse red/green/yellow to reflect Claude buffer state
- Yank-as-File - Yank large contents as file for clean terminal, with remote host support

Supported CLIs

Both are detected automatically. No configuration needed.

State Detection

Auto-response states and detection priority

Detection priority: Y/Y/N > Suggestion > Y/N > Running > User-Typing > Waiting

Examples

*Real-time demonstration of auto-response functionality*

Buffer List Dashboard

M-x ecc-list-buffers — centralized dashboard with timer status, config, and live debug log.

Dashboard preview

Installation

Add to your init.el:

Quick Start

Essential Commands

Basic Configuration

Auto-response, periodic commands, yank-as-file, keybindings

Testing

258 tests across 24 test…