atomix

绑定当前工作目录的终端 AI 编码助手。在项目目录里启动，它就以这个项目为上下文：读写代码、执行命令、编排子代理，会话历史与配置按项目天然隔离。

• 终端 TUI：Markdown 流式渲染、工具执行与权限确认卡片、todos 与上下文用量状态栏
• 多模型服务商：Anthropic / OpenAI / DeepSeek / Kimi / GLM / Qwen / MiniMax / OpenRouter 及自定义接口，首次运行向导配置
• 可扩展：skills、子代理、MCP 服务器、hooks、自定义斜杠命令，支持用户级与项目级两层配置
• 并行子代理：AgentTeam 以任务 DAG 一次编排多个子代理，无依赖任务并行执行

安装

需要 Node.js ≥ 20。

npm install -g atomix-cli

从源码构建见开发文档。

快速开始

atomix                      # 在当前目录启动交互会话（TTY 下为 TUI，否则回退基础 REPL）
atomix -C /path/to/project  # 指定工作目录
atomix -p "prompt"          # 一次性执行，stdout 只输出最终回复（适合脚本/管道）
atomix -r                   # 恢复历史会话（列表选择，或 -r <sessionId>）
atomix model                # 模型配置管理：list | add | use <名称> | quick <名称> | del <名称>

首次运行会进入模型配置向导，配置保存在 ~/.atomix/model.conf。

会话内使用

输入 /help 查看全部命令。常用交互：

| 输入 | 作用 | |---|---| | @文件路径 | 引用文件（自动路径补全；图片扩展名自动作为多模态发送） | | !命令 | 直接执行 shell 命令（输出仅本地显示，不进模型上下文） | | /resume /clear /compact | 切换会话 / 清空上下文 / 压缩上下文 | | /skills /agents /mcp /marketplace | 组件启停、列表与插件市场 | | /theme /glyphs /thinking | 主题 / 字形风格 / 思考开关 | | Ctrl+V | 粘贴剪贴板图片或文本 | | Esc / ↑↓ | 中断当前轮 / 输入历史 |

自定义命令放在 ~/.atomix/commands/（用户级）或 <项目>/.atomix/commands/（项目级），支持 $ARGUMENTS 替换。

数据与配置

~/.atomix/                # 用户级（环境变量 ATOMIX_ROOT 可覆盖）
├── model.conf            # 模型配置
├── history/<项目>/       # 会话历史，按项目隔离
├── skills/ agents/ commands/ mcp.json hooks.json
└── AGENT.md              # 全局规则

<项目目录>/
├── AGENT.md | CLAUDE.md  # 项目规则（即本项目的"人设"）
└── .atomix/              # 项目级 skills / agents / commands / mcp.json / hooks.json

文档

• 开发文档：从源码构建、架构、贡献指南
• 设计方案

License

MIT