agent-shell

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• Emacs（README 未标注最低版本要求）
• 可访问 MELPA 包仓库的网络环境
• 已安装并配置好的 ACP 代理 CLI（如 Claude Agent、Gemini CLI、Goose 等）
• 所用 LLM 代理对应的 API 密钥或登录凭证

安装与启动步骤

1. 1配置 MELPA 源

   在 Emacs 配置文件（如 init.el）中加入 MELPA 包仓库并初始化 package，否则无法搜索到 agent-shell。

   (require 'package)
   (add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/") t)
   (package-initialize)

   复制

2. 2安装 agent-shell

   刷新包索引后从 MELPA 安装 agent-shell，README 中的 MELPA 徽章表明这是官方发布渠道。

   (progn
     (package-refresh-contents)
     (package-install 'agent-shell))

   复制

3. 3安装 ACP 代理

   agent-shell 只负责在 Emacs 中展示，需另行按各代理官方文档安装 CLI，README 列出了可选代理链接。

4. 4启动 agent-shell

   在 Emacs 中打开 agent-shell 提供的原生 buffer 与代理交互，具体启动入口请以项目 README 为准。

如何确认成功

Emacs 中成功加载 agent-shell 并打开其专用 buffer，能收到 ACP 代理的流式响应即表示可用。

常见问题

注意事项

• README 节选中未包含正式安装与配置章节，上述安装步骤依据 MELPA 徽章和项目描述推断，请以仓库最新 README 为准。
• 每个 ACP 代理都需要单独安装并配置凭证，agent-shell 不会代为安装。
• 若包列表里搜不到 agent-shell，先执行 package-refresh-contents 刷新索引。
• 项目维护依赖赞助支持，README 中有 GitHub Sponsors 链接。