A native Emacs buffer to interact with LLM agents powered by ACP
980
Stars
135
Forks
13
Watchers
66
Issues
#+TITLE: Emacs Agent Shell #+AUTHOR: Álvaro Ramírez
[[https://melpa.org/#/agent-shell][file:https://melpa.org/packages/agent-shell-badge.svg]]
👉 通过 [[https://github.com/sponsors/xenodium][GitHub Sponsors]] 支持 [[https://github.com/xenodium][@xenodium]] 的工作（欢迎查看我的 [[https://xenodium.com][博客]]）
[[file:agent-shell.png]]
在您为这些实用的 LLM token 付费的同时，请考虑[[https://github.com/sponsors/xenodium][赞助]]本项目的开发与维护。有了您的帮助，我可以让这项工作更具[[https://github.com/sponsors/xenodium][可持续性]]。
谢谢！
[[https://xenodium.com/][Alvaro]]
一个原生的 Emacs shell，用于通过 ACP（[[https://agentclientprotocol.com][Agent Client Protocol]]，代理客户端协议）与 LLM 代理进行交互。
借助 agent-shell，您可以与 Gemini CLI、Claude Agent、Auggie、Mistral Vibe 或任何其他基于 ACP 驱动的代理进行对话。
在 [[https://www.youtube.com/watch?v=R2Ucr3amgGg][YouTube]] 上观看演示
[[https://www.youtube.com/watch?v=R2Ucr3amgGg][file:yt.png]]
=agent-shell= 依赖 [[https://github.com/xenodium/acp.el][acp.el]] 通过 ACP（[[https://agentclientprotocol.com/][Agent Client Protocol]]）与代理进行通信。
目前已有多个扩展包可以增强 =agent-shell= 的使用体验：
感谢 [[https://github.com/lobehub/lobe-icons][Lobe Icons]] 提供的精美图标。
** 外部依赖
*** Claude Agent SDK
对于 Anthropic 的 [[https://platform.claude.com/docs/en/agent-sdk/overview][Claude Agent SDK]]（前身为 Claude Code SDK），请遵循 [[https://github.com/zed-industries/claude-agent-acp][Zed 的 claude-agent-acp 指南]]，通常安装方式如下：
#+begin_src bash npm install -g @zed-industries/claude-agent-acp #+end_src
注意： =-g= 标志是必需的，以便全局安装二进制文件并使其出现在您的 PATH 中。安装完成后，请在终端中运行 =which claude-agent-acp= 来验证它是否可用。
*** Codex
对于 OpenAI 的 Codex，请安装 [[https://github.com/zed-industries/codex-acp][zed/codex-acp]] 并确保 codex-acp 可执行文件位于 PATH 中。
*** Gemini CLI
对于 Google 的 [[https://github.com/google-gemini/gemini-cli][Gemini CLI]]，请确保获取支持 =--experimental-acp= 标志的最新版本。
*** Goose
对于 Goose CLI，请安装 [[https://block.github.io/goose/docs/getting-started/installation][goose]] 并确保 goose 可执行文件位于 PATH 中。
*** Cursor
对于 Cursor 代理，请使用以下命令安装：
#+begin_src bash npm install -g @blowmage/cursor-agent-acp #+end_src
详情请参阅 https://github.com/blowmage/cursor-agent-acp-npm。
*** Kiro CLI
对于 Kiro CLI，请使用以下命令安装：
#+begin_src bash curl -fsSL https://cli.kiro.dev/install | bash #+end_src
详情请参阅 https://kiro.dev/docs/
agent-shell 是一个基于 Emacs Lisp 开发的原生 Emacs 缓冲区插件，旨在为用户提供与 LLM 智能体交互的统一接口。它通过支持代理客户端协议（ACP），使用户能够在 Emacs 环境内直接与 Claude Agent、Gemini CLI 等各种主流 AI 智能体进行对话与协作。
该插件支持通过 ACP 协议连接包括 Claude、Gemini、Mistral 在内的多种智能体服务。它在 Emacs 原生缓冲区中提供交互体验，实现无缝的对话与任务执行流程。该项目拥有丰富的生态插件支持，能够扩展侧边栏、书签管理、工作区切换及代码评审等高级功能。它利用 Emacs 的环境优势，将 AI 智能体的工作流深度集成到编辑器内部。
此工具适用于高度依赖 Emacs 进行日常开发工作的程序员与技术人员，特别适合需要在编码、代码评审或复杂任务处理中频繁调用 LLM 智能体辅助工作的用户场景。
![https://melpa.org/#/agent-shell][file:https://melpa.org/packages/agent-shell-badge.svg](https://melpa.org/#/agent-shell%5D%5Bfile:https://melpa.org/packages/agent-shell-badge.svg){kind=link}
![https://www.youtube.com/watch?v=R2Ucr3amgGg][file:yt.png](https://www.youtube.com/watch?v=R2Ucr3amgGg%5D%5Bfile:yt.png){kind=link}