爱意满满的作品展示区。
xiaoz
1.03D

告别 TUI,将任意 CLI Agent 进行 Web 可视化访问

  •  
  •   xiaoz ·
    helloxz · 2 days ago · 3426 views

    最近写了个小工具,可以将任意支持 ACP 协议的 CLI Agent 接入 Zacp ,然后提供 Web 可视化访问,目前测试过的 CLI 包括:Codex cli 、Reasonix cli 、Grok Build 、Pi Agent 、Omp 、Qoder 、Jcode ,有兴趣的朋友可以试试。

    开源地址:https://github.com/helloxz/zacp

    功能特性

    • 多 Agent 接入:支持 Codex cli 、Reasonix cli 、Grok Build 、Pi 、Omp 、Qoder 、Jcode 等 CLI Agent
    • Web 聊天界面:多会话、多 Agent 切换,流式输出实时展示
    • 实时通信:基于 WebSocket ,低延迟消息推送与权限回传
    • 权限确认:Agent 操作需经你在 Web 端手动确认
    • 并行任务:最多同时运行 3 个任务
    • 空闲回收:Agent 超时自动释放内存,下次使用即时恢复
    • 热管理:设置页随时启用/禁用 Agent ,无需重启
    • 数据持久化:历史记录存入本地 SQLite ,重启不丢失
    • 单文件发布:一个可执行文件包含前端与配置,即下即用
    • 登录保护:可选开启用户名密码验证
    • 一键安装/更新:自动检测系统与架构,支持全平台
    • 文件管理:支持上传、编辑、删除、重命名
    • Git 面板:快速查看仓库状态
    • 深色/浅色主题:自由切换

    适合什么场景使用?

    适合

    • 如果你经常使用某 CLI Agent 做开发,但是官方不提供可视化界面,那你可以用 Zacp 接入
    • 如果你需要在任意地方访问,Zacp 提供 WebUI 访问能力,让跨平台使用无障碍
    • 如果你只希望纯粹的写代码,不需要那么繁重的功能,那 Zacp 值得一试
    • 如果你需要多个 Agent 并行干活,那 Zacp 很适合你

    不适合

    • 不需要可视化操作的用户,只喜欢用 CLI
    • 习惯了 GUI 界面的用户,不在意内存占用
    • 日常仅使用一个 Agent 工具,没有多 Agent 切换需求
    • 需要更强大的能力,比如操作浏览器,操控电脑等,那 Zacp 不太适合

    部分截图

    主界面,支持多种不同的 Agent 选择。

    CleanShot 2026-08-10 at 12.50.15@2x.png

    对话界面,可直接对 Agent 发起开发任务需求,右侧面板支持文件管理器和 Git 信息状态展示。

    CleanShot 2026-08-10 at 12.52.16@2x.png

    在设置界面中可以对 Agent 进行启用或停用。

    CleanShot 2026-08-10 at 12.54.53@2x.png

    如果您需要外网访问,Zacp 也提供登录保护,直接在 [登录认证] 中设置账号、密码即可,确保公网访问安全。

    CleanShot 2026-08-10 at 12.56.34@2x.png

    也支持暗色和亮色模式一键切换。

    CleanShot 2026-08-10 at 13.15.25@2x.png

    Zacp 使用 Golang 开发,内存占用非常低。

    CleanShot 2026-08-10 at 12.58.51@2x.png

    注意:未统计 Agent 本身占用,不同 Agent 内存占用存在差异!!!

    安装和使用

    Zacp 提供 macOS 、Linux 、Windows 三大平台的一键安装脚本,您只需要复制安装命令执行即可。

    macOS & Linux

    curl -fsSL https://raw.githubusercontent.com/helloxz/zacp/main/install.sh | bash
    

    Windows

    请复制到 Powershell 命令行执行。

    irm https://raw.githubusercontent.com/helloxz/zacp/main/install.ps1 | iex
    

    然后输入:zacp命令启动即可。

    更多详细的说明可参考帮助文档: https://note.xiaoz.top/doc/zacp

    25 replies    2026-08-12 14:35:42 +08:00
    JSupM
        1
    JSupM  
       2 days ago   ❤️ 1
    开源不
    xiaoz
        2
    xiaoz  
    OP
       2 days ago
    @JSupM #1 ,开源的啊,帖子顶部留了 Github 开源地址。
    0xxb
        3
    0xxb  
       1 day ago   ❤️ 1
    不错不错
    iamnotcodinggod
        4
    iamnotcodinggod  
       1 day ago via Android   ❤️ 1
    hermes 支持吗
    PowerDi
        5
    PowerDi  
       1 day ago   ❤️ 1
    支持原设备上的历史会话吗?
    xiaoz
        6
    xiaoz  
    OP
       1 day ago
    @PowerDi #5 ,不支持呢,ACP 协议不会回传历史对话。接入后的新对话保存在 Zacp 数据库中。
    xiaoz
        7
    xiaoz  
    OP
       1 day ago
    @iamnotcodinggod #4 ,据我了解,Hermes 和 OpenClaw 都是支持 ACP 协议的,您可以参考自定义接入试试: https://note.xiaoz.top/doc/zacp/note-404
    tanszhe
        8
    tanszhe  
       1 day ago   ❤️ 1
    不错 就喜欢这种小巧的工具
    xiaoz
        9
    xiaoz  
    OP
       1 day ago
    @tanszhe #8 ,感谢支持。
    sitin
        10
    sitin  
       1 day ago   ❤️ 1
    赞,这种还是不错的
    Leeeeex
        11
    Leeeeex  
       17h 12m ago via iPhone   ❤️ 1
    好像没写支持 cc ?
    xiaoz
        12
    xiaoz  
    OP
       16h 55m ago
    @Leeeeex #11 ,我没用过 Cluade cli ,我了解了下,似乎原生不支持 ACP ,不过可以通过第三方 ACP 插件实现,然后参考自定义接入: https://note.xiaoz.top/doc/zacp/note-404
    ccvip
        13
    ccvip  
       16h 40m ago   ❤️ 1
    大佬又有新作品了!先 star 了再说。
    getadoggie
        14
    getadoggie  
       16h 13m ago via iPhone   ❤️ 1
    支持一些诸如/compact 、/shake 之类的命令吗?
    xiaoz
        15
    xiaoz  
    OP
       16h 10m ago
    @getadoggie #14 ,这个取决于后端 Agent 对/命令的支持情况,部分 Agent 是支持的,部分可能不支持。

    在聊天输入框输入/会展示可用的命令。
    ylsc633
        16
    ylsc633  
       16h 5m ago   ❤️ 1
    我写了个跟你类似的

    不过我写的是 app


    xiaoz
        17
    xiaoz  
    OP
       15h 50m ago
    @ylsc633 #16 ,不错,颜值比我的好太多了。

    我写 WEB 端的原因是方便在那些无桌面的 Linux 服务端使用,也能映射后方便公网访问。
    stefwoo
        18
    stefwoo  
       14h 8m ago via Android   ❤️ 1
    有没有可能 PWA ?
    xiaoz
        19
    xiaoz  
    OP
       13h 53m ago
    @stefwoo PWA 和手机 APP 在计划中。
    laibin6
        20
    laibin6  
       12h 44m ago
    没看到 claudecode ,支持吗?
    dushixiang
        21
    dushixiang  
       12h 41m ago   ❤️ 1
    赞,看起来非常不错
    lanweizhujiao
        22
    lanweizhujiao  
       12h 28m ago   ❤️ 1
    环境:mac + codex & claude code
    问题: 启动后项目 智能体未能正常识别到, 配置不了, 这是什么原因 怎么解决
    xiaoshouchen
        23
    xiaoshouchen  
       12h 28m ago   ❤️ 1
    强烈希望支持 Hermes agent
    xiaoz
        24
    xiaoz  
    OP
       12h 12m ago
    @lanweizhujiao #22 ,需要额外安装一个 code-acp 插件,参考这个文档: https://note.xiaoz.top/doc/zacp/note-400
    xiaoz
        25
    xiaoz  
    OP
       12h 11m ago
    @xiaoshouchen #23 ,Hermes 原生支持 ACP 协议,参考文档: https://note.xiaoz.top/doc/zacp/note-404 自定义接入即可。
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   1056 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 47ms · UTC 18:47 · PVG 02:47 · LAX 11:47 · JFK 14:47
    ♥ Do have faith in what you're doing.