Axe

一个用于管理和运行由 LLM 驱动的 Agent 的 CLI 工具。

为什么选择 Axe？

大多数 AI 工具默认你想拥有一个聊天机器人：一个拥有巨大上下文窗口、可以同时处理所有事情的长连接会话。但优秀软件的运作方式并非如此。优秀的软件应该是小巧、专注且可组合的。

Axe 对待 LLM Agent 的方式就像 Unix 对待程序一样。每个 Agent 只专注做好一件事。你可以在 TOML 文件中定义它，赋予它特定的技能，然后通过命令行运行它。通过管道输入数据，获取结果，将多个 Agent 串联起来。你可以通过 cron、git hooks 或 CI 等你现有的任何方式来触发它们。无需守护进程，无需 GUI，无需被任何框架绑定。只需一个二进制文件和你的配置文件即可。

概览

Axe 负责编排通过 TOML 配置文件定义的 LLM Agent。每个 Agent 都有其独立的系统提示词（System Prompt）、模型选择、技能文件（Skill files）、上下文文件、工作目录、持久化记忆，以及委托给子 Agent 的能力。

Axe 是执行器，而不是调度器。它的设计初衷是与标准的 Unix 工具（如 cron、git hooks、管道、文件监视器）配合使用，而不是重新发明调度或工作流编排。

特性

• 多模型提供商支持 — 支持 Anthropic、OpenAI、Ollama（本地模型）、OpenCode 以及 AWS Bedrock
• 基于 TOML 的 Agent 配置 — 声明式、可版本控制的 Agent 定义
• 子 Agent 委托 — Agent 可以通过 LLM 工具调用（Tool Use）机制调用其他 Agent，支持深度限制和并行执行
• 持久化记忆 — 带时间戳的 Markdown 日志，可跨执行任务保留上下文
• 记忆垃圾回收 — 支持 LLM 辅助的模式分析与清理
• 技能系统（Skill system） — 可重用的指令集，可在不同 Agent 之间共享
• Stdin 管道支持 — 可将任何输出直接通过管道传输给 Agent（例如 git diff | axe run reviewer）
• 本地 Agent 目录 — 在全局配置之前自动从 /axe/agents/ 发现 Agent，或者使用 --agents-dir 指定任意位置
• Dry-run（空运行）模式 — 在不调用 LLM 的情况下检查已解析的上下文
• JSON 输出 — 提供包含元数据的结构化输出，便于脚本编写
• 内置工具 — 局限于工作目录的文件操作（读取、写入、编辑、列表）；Shell 命令执行；URL 获取；网页搜索
• 输出允许列表 — 将 url_fetch 和 web_search 限制在特定的主机名；始终阻止私有/保留 IP（SSRF 防护）
• Token 配额 — 通过 [budget] 配置或 --max-tokens 标志限制每个 Agent 执行的累计 Token 使用量
• MCP 工具支持 — 通过 SSE 或可流式传输的 HTTP 协议连接到外部 MCP 服务器以获取额外工具
• 可配置重试 — 针对暂时的提供商错误（429, 5xx, 超时）提供指数、线性或固定退避策略
• 极简依赖 — 仅有四个直接依赖（cobra, toml, mcp-go-sdk, x/net）；所有 LLM 调用均使用标准库

安装

需要 Go 1.25+。

预编译二进制文件（无需安装 Go）可在 GitHub Releases 页面 获取，适用于 Linux、macOS 和 Windows。

通过 Go 安装：

go install github.com/jrswab/axe@latest

如果执行失败并提示 invalid go version，说明你的 Go 工具链版本低于 1.25。请前往 go.dev/dl 升级，或下载预编译二进制文件。

或者从源码构建：

git clone https://github.com/jrswab/axe.git
cd axe
go build .

快速开始

初始化配置目录：

axe config init

这会在 $XDG_CONFIG_HOME/axe/ 下创建目录结构，包含一个示例技能和一个用于存放提供商凭据的默认 config.toml。

创建一个新的 Agent 脚手架：

axe agents init my-agent

编辑其配置：

axe agents edit my-agent

运行该 Agent：

axe run my-agent

通过其他工具的管道输入数据：

git diff --cached | axe run pr-reviewer
cat error.log | axe run log-analyzer

示例

examples/ 目录包含了可立即运行的 Agent，你可以将其复制到你的配置中并立即使用。其中包括代码评审器、提交信息生成器和文本摘要器——每个都有一个专注的 SKILL.md。

# 将一个示例 Agent 复制到你的配置中
cp examples/code-reviewer/code-reviewer.toml "$(axe config path)/agents/"
cp -r examples/code-reviewer/skills/ "$(axe config path)/skills/"

# 设置你的 API Key 并运行
export ANTHROPIC_API_KEY="your-key-here"
git diff | axe run code-reviewer

完整设置说明请参考 examples/README.md。

Docker

Axe 提供了 Docker 镜像，用于在隔离的、加固的容器中运行 Agent。

构建镜像

docker build -t axe .

通过 buildx 支持多架构构建（linux/amd64, linux/arm64）：

docker buildx build --platform linux/amd64,linux/arm64 -t axe:latest .

运行 Agent

挂载你的配置目录并将 API Key 作为环境变量传入：

docker run --rm \
  -v ./my-config:/home/axe/.config/axe \
  -e ANTHROPIC_API_KEY \
  axe r