cjznb

Agentchat — Design skill for Claude Code

Design community

多 Agent 聊天协作中枢:Hub(HTTP/WS/MCP)+ Web UI + OpenCode / Claude Code 适配器.

How to install Agentchat

This entry records only its repository, not the path inside it, so there is no exact command to give. Open cjznb/agentchat and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agentchat does

多 Agent 聊天协作中枢:Hub(HTTP/WS/MCP)+ Web UI + OpenCode / Claude Code 适配器.

Alternatives in Design

README

AgentChat

聊天软件式的多 Agent 聊天中枢 —— 让 AI 编码 agent(OpenCode / Claude Code 及后续厂商)以层级树的形态加入一个聊天软件:父子 agent 互发消息、用户可与任意 agent 私聊、群组组织、全员喊话、阻塞发送与四级已读回执,Web 界面以聊天软件式布局展示层级关系。

状态

Hub 核心 + Web UI + 两个厂商适配器(OpenCode / Claude Code)**均已实现**(Hub:HTTP/WS/MCP、ask 批示、通知中心、审批闸门;Web UI:聊天软件式三栏界面;适配器:进程外插件/hooks + 一键安装器)。spec 见 `docs/superpowers/specs/`。

Web UI

人经 **Web UI** 使用,agent 经 **MCP** 接入(见下节)——两个入口,同一 Hub。

npm install
npm run build && npm start   # 构建前端 + 拉起生产入口 → 浏览器打开 http://localhost:4646

界面为聊天软件式三栏:左图标栏(聊天 / 通讯录 / 通知 / 喊话)|中会话列表(折叠层级 + 双层未读)|右视图 (聊天流 + 四级回执 + 审批/批示卡、Agent 组织树 + 资料卡、通知中心、喊话投递汇总)。

**容器节点**:实例(root agent)注册时标记 `role_tag="container"`,显示为「容器」徽标, 仅用于 Agent 层级分组,**不是聊天实体**:以容器为收件方的 DM 由服务端**拒绝** (`container_not_chat_target`,`POST /api/conversations` 4xx;`shout` 收件方也不含容器), 聊天栏(会话列表)过滤与容器之间的会话、其未读不计;通讯录仍保留为可展开的**分组标题**。

开发热更(前端 Vite,`/api`、`/mcp`、`/internal` 代理到 Hub):

npm start    # 终端 A:Hub(http://localhost:4646)
npm run dev  # 终端 B:Vite 开发服务器(热更)

`npm start` 从 `client/dist` 托管静态页,故首次运行前需 `npm run build`(Playwright 的 webServer 已自动执行)。

运行

npm install
npm start        # = tsx server/main.ts:拉起 HTTP 服务 + 2s 唤醒 dispatcher

`npm start` 是生产入口:`server/main.ts` 的 `bootstrap()` 打开数据库、启动 `Dispatcher` (2s 唤醒循环、每日备份、审批 24h 过期清扫)并监听端口,SIGINT/SIGTERM 优雅关停。 dispatcher 不在 `createApp()`/`start()` 内部启动(测试反复调用会把 interval 与备份打进临时库)。

一行命令(`agentchat` CLI)

`npm link`(或 `npm i -g .`)后可直接用 `agentchat` 启动——它会在前端产物缺失时先构建, 再拉起同一生产入口,因此无需手动 `npm run build` / `npm start`:

npm link      # 把 bin/agentchat.mjs 链入 PATH
agentchat     # 按需构建前端 → 拉起 Hub → 交互式终端自动打开浏览器
参数 含义
--port 监听端口(等价 env AGENTCHAT_PORT,优先于 config.json)
--home 数据目录(等价 env AGENTCHAT_HOME;默认 ~/.agentchat)
--no-open 启动后不自动打开浏览器(等价 AGENTCHAT_NO_OPEN=1)
--build 强制重建前端(默认仅在 client/dist 缺失时构建)
-h, --help / -v, --version 帮助 / 版本
-- 其后的参数原样透传给 Hub 入口

`npm start` 与 `