解压使用
- 下载对应系统的压缩包后解压, 压缩包内主要包含:
agentxx_cli : 可执行文件,运行可直接启动 tui 界面开始使用
agentxx-config.yaml/.env : 配置文件,agentxx_cli 运行必需
libagentxx 动态库 : 用于其他编程语言 ffi 调用
plugins: 内置插件,agentxx_cli 通过 agentxx-config.yaml 可以配置加载插件
修改配置
- 首先需要修改
agentxx-config.yaml 中的模型配置,预设了几种常用的模型,可以仿照抄写填想用的模型
- 然后需要在
.env 文件中填入你的 apikey
运行命令行TUI
windows 系统上使用
- 可以直接双击
agentxx_cli.exe 就会启动 TUI 界面
- 也可以先启动命令行 cmd 或 powershell 都行, 然后执行:
cd {agentxx_cli.exe 所在目录}
.\agentxx_cli.exe
linux 系统上使用
cd {agentxx_cli 所在目录}
./agentxx_cli
性能
- 内存占用 (外置加载5个常用插件 agentxx_filesystem, agentxx_execute_command, agentxx_system, agentxx_websearch, agentxx_planning):
| agentxx_cli Target |
初始化 RAM |
100K 上下文 |
200K上下文 |
TIP |
| Win/TUI |
4.2M |
13.2M |
19.7M |
任务管理器查看内存占用 |
| Linux/TUI |
3.2M |
9.2M |
15.1M |
top命令查看RES-SHR, agentxx_cli 仅依赖系统库,不需要其他动态库,因此仅计算独占内存大小 |
| System |
agentxx_cli |
libagentxx |
compiler |
TIP |
| Windows |
17.2M |
13M |
MSVC 19.51.36247.0/Visual Studio 18 2026 · x86_64 · -O2 |
打包时建议带上msvc运行时 |
| Linux |
22M |
16.1M |
GCC 16.1.0 · x86_64 · -O3 · --strip-unneeded |
打包时建议带上 libstdc++.so.6,libgcc_s.so.1 |
| Android |
- |
14.5M |
NDK-r29 · Clang 21.0.0 · android-21-arm64-v8a · -O3 · --strip-unneeded |
打包建议带上 libc++_shared.so |
- 插件动态库文件体积 (横线 - 表示该插件不支持此系统):
| Plugin |
Windows/.dll |
Linux/.so |
Androi/.so |
TIP |
| agentxx_codegraph |
37.2M |
43.6M |
37.7M |
代码分析定位,方便LLM快速查找代码中的函数、变量等符号的定义和引用 |
| agentxx_computer_use |
527K |
- |
- |
提供 tool 支持控制鼠标、键盘 |
| agentxx_execute_command |
5.7M |
2M |
6.2M |
Bash/powershell 命令行执行 |
| agentxx_filesystem |
9.5M |
14M |
6.4M |
文件读写 List/Read/Write/Edit/Glob/Grep |
| agentxx_javascript_engine |
1.2M |
1.4M |
1.2M |
Javascript代码执行引擎,可以依赖该插件实现JS插件 |
| agentxx_math |
531K |
503K |
301K |
数学计算工具 |
| agentxx_planning |
560K |
490K |
301K |
目标规划 + 渐进任务细节 两层任务规划 + 备忘录 |
| agentxx_rag_search |
6.9M |
8.7M |
7.5M |
RAG 检索 |
| agentxx_screen_capture |
544K |
- |
- |
获取屏幕图像帧 |
| agentxx_string |
9M |
13.7M |
1.6M |
字符串处理、HTML-Markdown转换 |
| agentxx_system |
616K |
572K |
328K |
系统工具 读取本地时间 |
| agentxx_system_monitor |
646K |
735K |
448K |
读取系统CPU、内存、GPU占用 |
| agentxx_text_selection_monitor |
550K |
- |
- |
接收系统的文本选择事件流 |
| agentxx_websearch |
6.9M |
8.8M |
7.7M |
网络搜索、下载、网页转Markdown |
更新日志
- Full Changelog: 0.3.0...v0.4.0
- 主要更改:
- 新增支持 Macos
- 重构 agent 内核的上下文管理,减少数据拷贝,降低内存占用和CPU占用
- 插件框架:
- 重构拆分基础库
- 重构 client UI 扩展,跟中断自定义UI 等复用,命名和行为更统一,提高兼容性
- 插件:
- codegraph 结果排序,优先展示代码文件的内容
- TUI:
- 完善部分 tool 的特化渲染
- 优化消息列表渲染性能
- 优化表格绘制
- 添加启动动画
- system prompt 中增加默认推荐的工作目录和临时目录
- 优化编译
- 完善性能测试和针对性的内存占用测试