Skip to content

开源 · 驱动任意 Agent

xacpx你的 Agent,就在聊天里

在微信、飞书、元宝、Discord 中驱动 Codex、Claude Code、Gemini 会话——无需打开终端。

$npm i -g @ganglion/xacpx
$xacpx login
$xacpx start
在聊天中操控 agent 的真机截图

驱动这些 Agent,运行在这些频道

Codex Claude Code Gemini Cursor Copilot OpenCode Droid Qwen Kimi OpenClaw Pi iFlow Kilocode Kiro omp Reasonix Qoder Trae
微信
飞书
Yuanbao元宝
Discord
实际效果

在一条对话里跑完整个会话

创建、提示、查看——全程不碰终端。

  1. 01

    创建会话

    一条命令绑定 agent 与工作区。

  2. 02

    发送提示词

    任何不以 / 开头的消息直达 agent。

  3. 03

    全程掌控

    随时 /status、/cancel、/use 切换。

网页看板

也可以在浏览器里遥控一切

自托管 relay hub,每个实例通过 WebSocket 拨入。在一个多租户看板里统一管理它们的全部会话——聊天、定时任务、编排;Agent 回复以实时 markdown 渲染,移动端也好用。

  • 多实例,一块屏

    你跑的每台机器都拨入同一个 hub。

  • 多租户且安全

    登录与连接器配对共用一个 access token;租户只见自己的实例。

  • 可安装 PWA

    把看板添加到主屏,回复以 markdown 流式渲染。

工作原理

一条消息,穿过整条管线

xacpx 把聊天消息桥接到运行在你机器上的 acpx Agent 会话。

逻辑会话

xacpx 管理:别名、Agent、工作区、每用户聊天上下文。

映射到

传输会话

acpx 管理:后端真实运行的命名 acpx 会话。

更多能力

不止是转发消息

多 Agent 编排

把任务分发给一队 Agent

一个协调者把子任务分发给多个 worker,再通过外部 MCP 接口汇总结果。

编排文档 →
定时任务

让提示词稍后自动触发

用 /later 排队相对或绝对时间的提示词——临时会话或绑定到已有会话。

定时任务 →
可扩展频道

把任意聊天平台插进核心

微信内置,飞书与元宝是官方插件——第三方频道遵循同一接口,无需改动核心。

开发频道 →

xacpx 是什么? ​

xacpx 是一个聊天频道控制台,用于远程控制 acpx Agent 会话。它充当聊天应用与运行在本机上的 Agent CLI 之间的桥梁,让你无需离开手机便能启动、切换和取消 Agent 任务。

你可以通过 xacpx 驱动 Codex、Claude Code、Gemini、OpenCode 以及 acpx 所支持的任何其他 Agent——全部在熟悉的消息界面中完成。

适用场景 ​

如果你需要轻量、随时随地访问长时间运行的 Agent 会话,xacpx 正是你所需的工具。典型场景包括:

  • 离开工位时监控或重定向 Agent。
  • 在单个聊天对话中管理多个并行会话,涵盖不同项目。
  • 无需打开终端即可将子任务委托给其他 Agent。

如果你的工作流完全在本地终端中进行,则无需使用 xacpx——它的价值体现在聊天频道层。

核心工作流 ​

典型流程分为四步:

  1. 启动后台守护进程 — xacpx start
  2. 创建或切换会话 — /ss codex -d /path/to/project 或 /use <alias>
  3. 发送纯文本提示词 — 任何不以 / 开头的消息都会被转发到当前会话
  4. 查看状态或取消 — /status、/cancel

会话模型。 xacpx 维护两个独立的会话状态层。逻辑会话由 xacpx 管理,保存别名、所选 Agent、工作区绑定以及每用户的聊天上下文。传输会话是实际运行在后端的 acpx 命名会话。/session new(简写 /ss)会同时创建这两者。/session attach 则只创建逻辑会话并绑定到一个已存在的传输会话——当你在后端已有独立运行的 acpx 会话,且希望在不干扰现有对话的前提下挂载 xacpx 聊天层时,这一命令非常有用。

支持的频道 ​

xacpx 内置微信作为默认频道。其他频道以官方插件包形式分发:

频道插件包安装说明
微信(内置)—快速开始
飞书@ganglion/xacpx-channel-feishu飞书教程
元宝@ganglion/xacpx-channel-yuanbao元宝教程
Discord@ganglion/xacpx-channel-discordDiscord 教程

第三方频道遵循相同的插件接口。使用 xacpx plugin add <package> 安装频道插件,使用 xacpx channel add <name> 配置,然后重启守护进程。

网页看板(relay hub) ​

聊天并不是驱动 xacpx 的唯一方式。你可以自托管 relay hub——一个内置多租户网页看板的 npm 包(@ganglion/xacpx-relay),在一个浏览器标签页里管理所有实例。每个实例通过 WebSocket 拨入 hub 并注册;hub 不持有你的会话,只负责把它们扇出到浏览器。

  • 三栏 IM 布局——实例/会话树、实时聊天流、定时任务 + 编排面板并排呈现。界面支持 English + 中文。
  • 实时 markdown 流式渲染——回复边到边渲染,工具调用与子 Agent 活动内联展示;可直接在浏览器里取消运行中的任务。
  • 移动端 PWA——添加到主屏幕后,用起来就像原生应用。
  • 部署极简——一条 npm i -g,默认单端口,SQLite 用内置的 node:sqlite/bun:sqlite,无需编译原生依赖。
  • 多租户 + 令牌认证——一个令牌就是一个用户;令牌哈希落盘,同一个 access token 既用于网页登录也用于连接器配对。给他人开号可用一次性邀请链接(xacpx-relay add invite)。
bash
npm i -g @ganglion/xacpx-relay
xacpx-relay add token   # 仅打印一次 access token
xacpx-relay start       # 看板 + API 在 :8787

完整流程——配对、邀请码、TLS、systemd、备份——见自托管 Relay Hub。

下一步 ​

  • 快速开始 — 安装 xacpx、登录并运行第一个会话
  • Discord 频道 — 创建 Discord Bot、配置 allowlist,并发送第一条 Agent 提示词
  • 命令参考 — 聊天命令完整列表(/ss、/use、/cancel 等)
  • 自托管 Relay Hub — 为多个实例运行多租户网页看板
  • 配置说明 — 配置文件字段、传输选项以及工作区和 Agent 注册
  • 插件开发 — 构建你自己的频道插件

基于 MIT 许可证发布。