一个快速、轻量的cli。

AX

用 Rust 构建的快速、轻量终端 AI Agent。

同一源码工作区可构建 Windows、Linux 和 macOS 版本。原生构建目标、Shell 设置、安装方式及能力限制见平台支持；新平台压缩包需要对应 Release 发布后才能下载。

English | 简体中文

AX 是一个小巧的原生终端 Agent：启动快、流式响应，会话、记忆、凭证与模型配置都留在你的机器上——无需注册任何服务，没有远程遥测。

AX 是 Agent；AX Crew 是与它一同构建的控制平面——编排并控制多台机器上的 AX，并在机器掉线时让工作继续运行。参见 ACP 与 Crew 集成。

Rust 原生 — 核心终端 Agent 为单一二进制，不需要 Node 或 Docker；可选的浏览器操作需要 Node 和 Playwright。
独立界面权限 — 应用、网站访问与具体操作审批分别管理，不改变文件和终端的沙箱。电脑操作默认开启，并保留用户显式关闭的设置；Windows UIA、Linux AT-SPI 和 macOS Accessibility 适配器有各自的平台要求与限制。参见电脑操作和主机访问权限。
启动快 — 供应商、技能、MCP 服务器与记忆按需加载。
本机资源 — /system 按需采集真实 CPU、内存以及受支持 NVIDIA 显卡的使用率与显存；读取失败明确显示不可用。
标准技能与聚焦工具 — Agent Skills SKILL.md 包（惰性指令 + 可选资源）、只读的 web 搜索/抓取（并发批量查询与页面抓取并去重结果）、通过可配置 MCP 服务器接入的 LSP，以及受支持视觉模型上的原生图片输入。
二进制小巧 — 紧凑的聚焦 crate 工作区，不是框架。
简单工作流 — 输入、得到回答、切换模型、继续。
本地优先 — 会话、记忆与设置存放在 AX 可执行文件旁的 .ax 中。

暂无公开 benchmark；这里的"快"指的是启动路径在设计中尽量少做事。

默认情况下，AX 将持久化数据存放在 <install-dir>/.ax 下，项目级数据在 projects/<project-key>/ 下。打开其他工作目录不会把数据搬过去；删除工作区不会删除其历史。首次启动时，旧版 ~/.ax 与已知项目 .ax 存储会被复制（不删除原文件）。AX_HOME 与 --data-dir 仍是显式覆盖项。

便携备份：ax export backup.axpack 导出会话与记忆；用 --memory 或 --sessions 选择类型。先运行 ax import backup.axpack --dry-run 检查冲突，再运行 ax import backup.axpack 合并。凭证与缓存不包含在内。详见备份细节。

快速开始

安装并运行 AX

Mac 或 Linux：

curl -fsSL https://raw.githubusercontent.com/Axium-Labs/AX/main/scripts/install.sh | sh

Windows：

powershell -ExecutionPolicy Bypass -c "iex ((iwr 'https://raw.githubusercontent.com/Axium-Labs/AX/main/scripts/install.ps1' -UseBasicParsing).Content)"

然后直接运行：

ax

第一个会话：

/login      # 用供应商登录（Codex OAuth 或 API Key）
/model      # 选择模型
hello       # 直接开始输入

就这些。会话自动保存，所选模型下次启动时会被记住。

安装

安装器从 GitHub Releases 拉取最新版本，用该版本的 SHA256SUMS 校验压缩包，安装单个 ax / ax.exe 二进制：

macOS / Linux — 默认安装到 ~/.local/bin，若该目录不在 PATH 中会打印提示。
Windows — 默认安装到 %LOCALAPPDATA%\Programs\AX\bin，并加入用户 PATH（仅当尚未存在时）。

两个安装器都接受两个环境变量：

变量	作用
`AX_VERSION`	安装指定 release tag 而非最新版（默认：最新）
`AX_INSTALL_DIR`	覆盖安装目录

要把当前正在运行的二进制更新到最新 GitHub Release，运行 ax --update。AX 检查 release 版本、用 SHA256SUMS 校验下载并替换该二进制；同时从同一压缩包刷新内置负载，把缺失的技能包安装到 <install-dir>/.ax/skills，且仅在尚无配置时写入 <install-dir>/.ax/mcp.toml（已有技能与配置保持不变）。每次 ax --update 都会刷新内置负载（即使二进制已是最新），因此新增技能包无需升版本即可生效。在 Windows 上，校验过的更新会在命令退出后计划替换；重启 AX 后再使用新版本。该命令不会改动你的 <install-dir>/.ax 用户数据或任何项目的 .ax 目录。若你用 AX_INSTALL_DIR 安装了独立副本，请运行该副本的 ax --update 更新。仅推送 main 不算发布；发布工作流针对 v* tag 运行。

curl -fsSL https://raw.githubusercontent.com/Axium-Labs/AX/main/scripts/install.sh | sh
AX_INSTALL_DIR="$HOME/bin" curl -fsSL https://raw.githubusercontent.com/Axium-Labs/AX/main/scripts/install.sh | sh

powershell -ExecutionPolicy Bypass -c "iex ((iwr 'https://raw.githubusercontent.com/Axium-Labs/AX/main/scripts/install.ps1' -UseBasicParsing).Content)"

卸载

移除 AX 只需删除二进制（Windows 上还要删除安装器加入的 PATH 项）。AX 的数据单独存放在 <install-dir>/.ax，想彻底清空也可以一并删除。

macOS / Linux

rm -f ~/.local/bin/ax        # 或 AX_INSTALL_DIR 指向的位置
rm -rf ~/.local/bin/.ax                 # 配置、会话、记忆、模型目录（可选）

Windows

Remove-Item -Force "$env:LOCALAPPDATA\Programs\AX\bin\ax.exe"
# 移除安装器加入的 PATH 项（可选但更整洁）
$p = [Environment]::GetEnvironmentVariable('Path', 'User')
[Environment]::SetEnvironmentVariable('Path', ($p -split ';' | Where-Object { $_ -notlike '*Programs\AX\bin*' }) -join ';', 'User')
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\Programs\AX"   # 一并删除存储的会话与记忆（可选）

开发

从源码构建

需要 Rust 1.92+。

git clone https://github.com/Axium-Labs/AX.git
cd AX
cargo build --release
# 二进制位于 target/release/ax.exe（Windows）或 target/release/ax（Unix）

供应商与模型

AX 从你机器上已有的东西发现供应商——<install-dir>/.ax/auth.json 中的凭证与 DEEPSEEK_API_KEY 等标准环境变量。启动时不发生任何网络调用。

供应商	凭证	用法
OpenAI Codex	OAuth 登录	`/login` → Codex OAuth
WorkBuddy International	浏览器 OAuth + token 轮询	`ax auth login workbuddy --region intl`，或 `/login` → WorkBuddy International
WorkBuddy China	浏览器 OAuth + token 轮询	`ax auth login workbuddy --region cn`，或 `/login` → WorkBuddy China
DeepSeek	API Key	`/login` → API Key，或 `DEEPSEEK_API_KEY`
OpenAI	API Key	`/login` → API Key，或 `OPENAI_API_KEY`
OpenAI 兼容供应商（Groq、Mistral、OpenRouter 等）	供应商 API Key	`/login` → 供应商，或其 API Key 环境变量

模型动态发现并写入 <install-dir>/.ax/models/（内置目录 + 各供应商刷新缓存）。随时用 /model 切换；上次选择——供应商、模型与推理强度——持久化到 <install-dir>/.ax/config.json，下次启动恢复。

从命令行显式指定供应商：

ax --provider deepseek
ax --provider openai-codex --model <model-id>
ax run "explain this repo" --provider deepseek

--provider 接收目录中的供应商 id，而不仅是 deepseek / openai / codex / compatible 别名。同一供应商有多个条目时，请明确指定其 id——小米的普通条目与 CN/SGP/AMS token 套餐区域共享模型 id 但端点不同：

ax run "explain this repo" --provider xiaomi-token-plan-cn --model mimo-v2.5

用法

启动 UI（默认）：

ax

运行单个任务后退出（非交互）：

ax run "summarize the TODOs in ./src"

以有界并发运行独立任务：

ax agents "review pr #12" "write changelog" --concurrency 2

要把 AX 现有运行时暴露给 ACP 客户端，运行 ax acp。要把本机连接到 AX Crew 后端，先运行 ax crew pair <code> --gateway <https-url> 一次，再运行 ax crew connect <https-url>。参见 ACP 与 Crew 集成。