Go 写的 CLI vibe coding agent。用自然语言描述需求，axe 自动读取项目上下文、调用 LLM 生成代码、创建/修改文件、执行命令。
- 🌊 流式输出 — SSE streaming 逐字打印，实时看到 AI 思考过程
- 💾 对话历史 — 自动保存（按项目维度），支持恢复上次对话
- 📊 Token 用量 + 费用 — 每轮显示 token 消耗和美元费用估算
- 🤖 多模型支持 — Anthropic Claude + OpenAI 兼容接口，自动 fallback
- 📝 项目感知 — 自动读取 CLAUDE.md 项目指令、.axeignore 忽略规则、智能检测项目类型
- ✏️ diff 预览 — 文件修改前显示变更对比，需确认才执行
- 📦 自动 commit — 每轮完成后自动 git commit，方便回滚
- 🔐 权限记忆 — 支持 "Always allow" 记住授权决策，避免重复确认
- 🗜️ 上下文压缩 — 长对话自动压缩，防止超出 token 限制
- 🎨 Markdown 渲染 — 终端中渲染代码高亮、表格、列表等
- 🔧 自定义命令 —
.axe/commands/目录下定义项目专属命令 - 📋 项目级配置 —
.axe/settings.yaml覆盖全局配置 - 🖥️ Pipe 模式 —
--print或 stdin 管道，适合 CI/CD 集成 - 🖼️ 图片理解 — prompt 中直接写图片路径，自动发送给 Vision 模型
- ⏪ Undo 撤销 —
/undo基于 git 撤销上一次修改 - 📎 @file 引用 — prompt 中
@path/to/file自动内联文件内容 - 🔍 多语言自动验证 — Go/Python/Rust/TypeScript 修改后自动编译检查
- 💰 Token 预算 —
/budget设置费用上限，防止意外消耗 - 🔍 对话搜索 —
/search搜索历史对话内容 - ⌨️ 中文友好 — 完整的 CJK 输入支持
- 🤖 API 自动重试 — 限流/服务器错误时自动退避重试
- 🧩 Skills 技能系统 — YAML 定义技能包，扩展 system prompt 和工具
- ✅ 批量确认 — 连续同类工具调用时合并为一次确认
go install github.com/Lewis-404/axe@latest或本地编译：
git clone https://github.com/Lewis-404/axe.git
cd axe
go build -o axe .axe init编辑 ~/.axe/config.yaml：
# 至少配置一个模型，支持多个模型自动 fallback
models:
- provider: anthropic # anthropic 或 openai
api_key: "your-api-key"
base_url: "https://api.anthropic.com"
model: "claude-sonnet-4-20250514"
max_tokens: 8192
# 备用模型（可选，第一个失败时自动切换）
# - provider: openai
# api_key: "sk-xxx"
# base_url: "https://api.openai.com"
# model: "gpt-4o"
# max_tokens: 8192也支持环境变量：
# Anthropic
export ANTHROPIC_API_KEY="sk-xxx"
export ANTHROPIC_BASE_URL="https://your-proxy.com"
# OpenAI
export OPENAI_API_KEY="sk-xxx"
export OPENAI_BASE_URL="https://api.openai.com"# 交互模式
axe
# 单次执行
axe "帮我写一个 HTTP server"
# 非交互模式（只输出文本，自动允许所有操作）
axe --print "解释这段代码"
# 自动模式（完整UI但自动允许所有操作）
axe --auto "重构这个函数"
# 管道模式
echo "帮我写一个排序函数" | axe
cat error.log | axe "分析这个错误"
# 恢复上次对话
axe --resume
# 列出最近对话
axe --list
# 初始化配置
axe init
# 查看版本
axe version在交互模式中支持 / 命令：
| 命令 | 功能 |
|---|---|
/clear |
清空对话上下文并清屏 |
/compact [hint] |
压缩对话上下文（可带提示指导方向） |
/init |
为当前项目生成 CLAUDE.md |
/list |
查看最近对话记录（带编号） |
/resume |
列出最近对话，选择并恢复（展示完整历史） |
/resume <编号> |
恢复指定对话（编号从 /list 获取） |
/model |
查看当前和可用模型 |
/model <name> |
切换模型 |
/fork |
从当前对话创建分支 |
/ask <model> <prompt> |
临时用另一个模型回答 |
/search <keyword> |
搜索历史对话 |
/undo |
撤销上一次 git commit |
/diff |
查看未提交的变更 |
/retry |
重试上一轮对话 |
/export [file] |
导出对话为 Markdown |
/git [cmd] |
快捷 git 操作 |
/context |
查看上下文 token 用量 |
/skills |
查看已加载的技能 |
/budget <$> |
设置费用上限 |
/cost |
查看累计 token 用量和费用 |
/project:<name> |
执行自定义项目命令 |
/help |
显示命令列表 |
/exit |
退出 Axe |
axe 内置 9 个工具供 LLM 调用：
| 工具 | 功能 |
|---|---|
read_file |
读取文件内容 |
write_file |
创建/覆盖文件（已有文件需确认） |
edit_file |
精确替换文件内容（需确认） |
list_directory |
列出目录结构 |
execute_command |
执行 shell 命令（需确认） |
search_files |
grep 搜索文件内容 |
glob |
按文件名模式搜索（如 **/*.go） |
bg_command |
后台进程管理（启动/状态/停止/日志） |
think |
内部思考，用于任务规划 |
工具确认时输入 A (Always) 可记住授权决策：
- 命令执行：按命令前缀记忆（如允许所有
go命令） - 文件写入/编辑：可设为始终允许
权限存储在 ~/.axe/permissions.yaml，可手动编辑。
axe 会自动读取项目根目录的以下文件：
- CLAUDE.md / .axe.md — 项目指令，作为额外 system prompt
- .axeignore — 忽略规则，格式同 .gitignore
- .gitignore — 自动跳过匹配文件
智能检测项目类型（Go/Python/Node/Rust），自动读取对应关键文件作为上下文。
对话按项目维度存储在 ~/.axe/history/<project>/ 下，不同项目的历史互不干扰。
在项目根目录创建 .axe/settings.yaml 可覆盖全局配置：
# 项目专用模型（优先于全局配置）
models:
- provider: openai
api_key: "sk-xxx"
model: "gpt-4o"
max_tokens: 16384在 .axe/commands/ 目录下创建 .md 文件，文件名即命令名：
# 创建命令
mkdir -p .axe/commands
echo "运行所有测试并修复失败的用例" > .axe/commands/fix-tests.md
echo "检查代码风格，修复 lint 问题" > .axe/commands/lint.md
# 使用
/project:fix-tests
/project:lint--print 模式适合脚本和 CI/CD 集成：
# 代码审查
git diff | axe "审查这些变更"
# 错误分析
cat error.log | axe "分析错误原因"
# 生成文档
axe --print "为 main.go 生成 godoc 注释" > doc.goaxe 支持 Model Context Protocol，可连接外部 MCP 工具服务器扩展能力：
# ~/.axe/config.yaml 或 .axe/settings.yaml
mcp_servers:
filesystem:
command: "npx"
args: ["-y", "@modelcontextprotocol/server-filesystem", "/path"]
github:
command: "npx"
args: ["-y", "@modelcontextprotocol/server-github"]MCP server 提供的工具会自动注册，LLM 可以直接调用。
MIT