โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โ
โ โโโโโโโโโโโโโโโ โโโโโโ โโโโโโโ โโโโโโโ โโโโโโ โโโโโโโ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โโโโโโ โโโโโโโโโโโโโโโโโโโ โโโ โโโโโโโโโโโโโโโโโโโ โ
โ โโโโโโ โโโโโโโโโโโโโโโโโโโ โโโ โโโโโโโโโโโโโโโโโโ โ
โ โโโโโโโโโโโ โโโโโโ โโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโ โ
โ โโโโโโโโโโโ โโโโโโ โโโ โโโโโโโโ โโโโโโโ โโโ โโโโโโ โ
โ โโโโโโโ โโโโโโโโ โ
โ โโโโโโโโ โโโโโโโโ โ
โ โโโ โโโโโโโโโโ โ
โ โโโ โโโโโโโโโ โ
โ โโโโโโโโโโโโโโโโโ โ
โ โโโโโโโ โโโโโโโโ โ
โ .el โ Emacs LLM Agent Shell โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
A native comint experience for ACP-powered AI agents
Overview โข Features โข Installation โข Quick Start โข Supported Agents โข Configuration โข Documentation
acp.el brings the power of Agent Client Protocol (ACP) directly into Emacs. Interact with Claude Code, Gemini CLI, Codex, and other AI agents through a native shell interface built on comint-mode.
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ acp.el Architecture โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ โ
โ โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ โ
โ โ Your Emacs โ โ
โ โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ โ
โ โ โ acp.el โ โ โ
โ โ โ โโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโโโโโ โ โ โ
โ โ โ โ UI โ โ Sessions โ โ Agents โ โ โ โ
โ โ โ โ Layer โ โ Manager โ โ Layer โ โ โ โ
โ โ โ โโโโโโฌโโโโโ โโโโโโฌโโโโโโ โโโโโโโโฌโโโโโโโ โ โ โ
โ โ โโโโโโโโโโผโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโผโโโโโโโโโโโ โ โ
โ โฐโโโโโโโโโโโผโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโฏ โ
โ โ โ โ โ
โ โผ โผ โผ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ comint-mode โ โ
โ โ (Terminal Interface) โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ โ
โ โผ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ ACP Protocol โ โ
โ โ (Agent Client Protocol) โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ โ
โ โผ โ
โ โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโ โ
โ โClaude โ โGemini โ โCodex โ โGoose โ โOther โ โ
โ โ Code โ โ CLI โ โ โ โ โ โAgents โ โ
โ โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโ โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
| ๐ค Multi-Agent | ๐ Native Shell | ๐พ Sessions |
| Claude, Gemini, Codex & more | Built on comint-mode | Save, resume, switch |
| ๐ง MCP Support | ๐ฆ Containers | ๐จ Rich UI |
| Model Context Protocol | Docker & devcontainers | Syntax, collapsible blocks |
| ๐ Transcripts | โก Keybindings | ๐ Hot Reload |
| Export as Markdown | Full Emacs keybindings | Reload without restart |
;; Using use-package
(use-package acp
:ensure t)
;; Or straight.el
(straight-use-package 'acp)(add-to-list 'load-path "/path/to/acp.el")
(add-to-list 'load-path "/path/to/acp.el/agents")
(add-to-list 'load-path "/path/to/acp.el/ui")
(add-to-list 'load-path "/path/to/acp.el/features")
(require 'acp)| Package | Version | Description |
|---|---|---|
| Emacs | 29.1+ | Core requirement |
| shell-maker | 0.89.2+ | Shell interface |
| acp | 0.11.1+ | ACP protocol |
;; Basic usage
M-x acp
;; Or start specific agent
M-x acp-anthropic-start-claude-code
M-x acp-google-start-gemini| Keys | Action |
|---|---|
C-c C-c |
Interrupt agent |
TAB |
Next item |
S-TAB |
Previous item |
C-c C-v |
Set session model |
C-c C-o |
Switch buffer |
C-c C-m |
Set session mode |
M-p/M-n |
Command history |
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Agent Support Matrix โ
โโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ Agent โ Company โ Features โ
โโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ Claude Code โ ๐ฆ Anthropic โ Files, Edit, Bash, Search, Multi-turn โ
โ Gemini CLI โ ๐ต Google โ Files, Bash, Search, MCP โ
โ Codex โ ๐ข OpenAI โ Files, Edit, Bash, Code execution โ
โ Goose โ ๐ฆ Block โ Files, Bash, Search, MCP โ
โ Cursor โ ๐ Cursor โ Files, Edit, Bash, Chat โ
โ Qwen Code โ ๏ฟฝ Alibaba โ Files, Bash, Search โ
โ Mistral Vibe โ ๐ท Mistral โ Files, Edit, Bash โ
โ Kiro CLI โ โก Kiro โ Files, Bash, Search โ
โ Auggie โ ๐ Augment โ Files, Edit, Bash โ
โ Factory Droid โ ๐ค Factory โ Files, Bash, Search โ
โ Pi โ ๐ Pi AI โ Files, Edit (Beta) โ
โ OpenCode โ ๐ฆ OpenCode โ Files, Bash (Beta) โ
โโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
(require 'acp)
;; Set preferred agent
(setq acp-preferred-agent-config
(acp-anthropic-make-claude-code-config))
;; Authentication (choose one)
(setq acp-anthropic-authentication
(acp-anthropic-make-authentication :api-key "sk-ant-..."))
;; Or login via browser
(setq acp-anthropic-authentication
(acp-anthropic-make-authentication :login t))(setq acp-anthropic-claude-environment
(acp-make-environment-variables
"HTTPS_PROXY" "http://proxy.example.com:8080"
"HTTP_PROXY" "http://proxy.example.com:8080"))
;; Inherit parent Emacs environment
(setq acp-anthropic-claude-environment
(acp-make-environment-variables :inherit-env t))(setq acp-mcp-servers
'(; Example: Filesystem access
((name . "filesystem")
(type . file-system)
(config . ((allowedDirectories . ["~/"]))))
; Example: Notion integration
((name . "notion")
(type . http)
(url . "https://mcp.notion.com/mcp"))));; Run agents inside containers
(setq acp-command-prefix '("devcontainer" "exec" "--workspace-folder" "."))
;; Path resolution
(setq acp-path-resolver-function #'acp-devcontainer-resolve-path)| Guide | Description |
|---|---|
| ๐ AGENTS.md | Project guidelines & architecture |
| ๐ CONTRIBUTING.org | How to contribute |
| ๐ GEMINI.md | Gemini CLI setup & tips |
| ๐ CLAUDE.md | Claude Code guide |
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ acp.el Roadmap โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ ๐ง v0.50 (Next Release) โ
โ โโโ ๐ Session persistence & history โ
โ โโโ ๐ Multi-agent orchestration โ
โ โโโ ๐ Usage analytics dashboard โ
โ โ
โ ๐ v0.60 (Planning) โ
โ โโโ ๐ Web search integration โ
โ โโโ ๐ Integrated file tree browser โ
โ โโโ ๐จ Theme customization engine โ
โ โ
โ ๐ฎ Future Ideas โ
โ โโโ ๐ค Agent-to-agent communication โ
โ โโโ ๐ฑ Mobile companion app โ
โ โโโ ๐ฎ TUI mode for terminal Emacs โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Star this repository to show your support!
Sponsor ยท Report Bug ยท Request Feature
Made possible by the Emacs community