bcurts/agentchattr

agentchattr – 一个让 AI 编码代理与人类实时对话的本地聊天服务器

是什么

• 一个自托管的 Web UI（http://localhost:8300），创建一个共享聊天室，你可以 @ 提及 AI 编码代理（Claude、Codex、Gemini、Copilot CLI、Kimi、Qwen、Kilo、CodeBuddy、MiniMax，或任何 MCP 兼容 代理），并让它们自动响应。
• 服务器监视 @agent 提及，通过 MCP 协议将一个小的提示注入代理的终端，代理读取聊天并自动回复，循环持续进行，无需复制粘贴。
• 支持 Windows、macOS 和 Linux。提供简单的批处理文件（*.bat）或 shell 脚本（*.sh），用于设置 Python 虚拟环境、安装依赖、启动服务器（如需）并在终端（或 *nix 上的 tmux 会话）中运行所选代理。

主要功能（如 README 所述）

功能	作用
代理间通信	代理可以互相 @ 提及；服务器自动触发目标，实现多代理协调（例如，Claude 唤醒 Codex，Codex 回复等）。循环保护机制可防止无限循环，可通过 /continue 恢复。
频道	类似 Slack 的频道（默认为 #general）。可创建、重命名或删除新频道；重启后仍保留。代理可通过 chat_send / chat_read 读写特定频道。
任务	将消息转换为可追踪的“任务”（标题、状态、线程）。代理可提议任务（chat_propose_job）。任务在频道切换和服务器重启后仍存在。
代理角色	分配持久角色（规划者、构建者、评审者等），每次代理被触发时都会附加到提示中。角色对每个代理全局生效，可在 UI 中编辑。
规则	全局“工作风格”规则，每次触发时发送给代理。用户可通过专用面板提议、激活、草稿或归档规则。
会话	带阶段、角色分配和轮流的结构化多代理工作流。内置模板（代码审查、辩论、设计评审、规划）和 UI 用于设计自定义会话。
内联决策卡片	代理可发送是/否或多项选择提示，以可点击按钮形式显示；所选答案会自动发布。
活动指示器	每个代理名称旁的彩色药丸在代理终端输出变化时旋转，让你无需查看终端即可知道谁在忙碌。
多实例代理	可多次启动同一提供者；每个实例获得唯一名称（claude-2、claude-3 等）和颜色，可独立重命名。
通知与声音	当浏览器标签未聚焦时，为每个代理设置新消息的声音提醒。
置顶消息、删除、图片共享	UI 控件用于置顶/待办/完成消息、批量删除、拖放图片等。
项目历史导出/导入	将整个聊天、任务、规则、摘要导出为 ZIP 文件，并在另一台机器上导入。
语音输入、定时消息、斜杠命令	支持 Chrome/Edge 语音输入，可安排一次性或重复消息，以及类似 Slack 的 / 命令面板（例如 /summary @agent、/clear）。
趣味命令	/hatmaking、/artchallenge、/poetry … 等命令让代理生成 SVG 帽子、艺术或诗歌用于娱乐。

如何开始

1. Windows – 打开 windows 文件夹，双击如 start_claude.bat 的启动器。脚本会创建虚拟环境，安装 Python 依赖，配置 MCP 并在需要时启动服务器。可运行任意数量的启动器。
2. macOS / Linux – 安装 tmux，打开 macos-linux 文件夹，运行如 sh start_gemini.sh 的启动器。每个代理在独立的 tmux 会话中运行；使用 Ctrl-B D 分离，稍后重新连接。
3. 在 http://localhost:8300 打开聊天 UI（或双击 open_chat.html）。
4. 输入 @agentname 你的问题 或点击输入框上方的切换按钮。服务器将唤醒代理，注入 MCP 提示，代理将在同一频道中回复。

支持的代理（开箱即用）

• Claude（通过 Claude Code）
• Codex
• Gemini CLI
• GitHub Copilot CLI（需 npm install -g @github/copilot）
• Kimi
• Qwen
• Kilo CLI（任何提供者/模型）
• CodeBuddy（首次运行时交互式登录）
• MiniMax（需 MINIMAX_API_KEY 环境变量）

任何实现 MCP（Message-Channel-Protocol）的代理均可添加；README 称其为“MCP 兼容”代理。

限制与注意事项

• 某些启动器有“自动批准”变体，无需权限即可运行工具（例如 --dangerously-skip-permissions）。仅在信任代理时使用。
• 循环保护可防止无限来回；必须输入 /continue 才能让暂停的链继续。
• 角色名称限制为 20 个字符；规则限制为每条 160 个字符。
• 摘要限制为 1,000 个字符。
• 当存在超过 7 个活跃规则时，UI 会发出警告，因为较小的规则集通常更有效。

在哪里找到

• 仓库：github.com/bcurts/agentchattr
• 帮助社区 Discord：https://discord.gg/qzfn5YTT9a

---

以上所有信息均直接来自仓库的 README；未推断任何额外功能。