Open Max：终端中运行的自扩展 Rust 编程 Agent 载体

核心能力与快速开始

★ 4 · Rust

能做什么

提供终端中的编程 agent 循环，内置七个原生工具（list_dir、read_file、write_file、edit_file、glob、grep、bash）并流式显示工具调用；支持通过 settings.json 配置 base_url、model、api_key、approval_mode、context_tokens、max_parallel_tools，也可用 providers.json 配置多个命名端点并用 /model 切换；模型端点需返回结构化 API tool_calls 才能使用工具。支持文件式扩展：.openmax/tools/*.toml 工具、.agents/skills/*/SKILL.md 技能、.agents/prompts/*.md 提示模板、.openmax/hooks/ 生命周期钩子、.openmax/permissions.toml 权限规则，并提供 openmax --check 校验与 openmax --spec <surface> 输出编写契约。支持 .openmax/memory/ 中一文件一条持久事实的记忆机制，以及 openmax --recall "<query>" 对会话、压缩归档、摘要和记忆做 BM25 相关性加时间衰减的流式检索。提供全屏 TUI、无头打印模式和 openmax-stdio/6 协议供自定义前端接入。项目信任机制要求先信任规范项目根目录，未信任时无头与 stdio 运行会 fail closed。

适用场景

在终端中对本地代码库进行读写、检索和命令执行的编程辅助；接入本地模型服务器（Ollama、LM Studio、vLLM、llama.cpp）或云端网关、私有代理来驱动编程 agent；在脚本和 CI 中使用无头打印模式或 --json 事件输出；借助 TOML 工具、SKILL.md 技能、提示模板、hooks 和权限规则自定义并扩展 agent 能力；通过 --recall 检索项目历史会话与记忆内容；为自定义前端实现 openmax-stdio/6 协议接入。

项目形态

可直接使用的工具

部署方式

安装方式包括 Homebrew（macOS/Linux）、安装脚本 curl -fsSL https://useopenmax.dev/install.sh | sh、bun/npm 全局包 openmax-cli，或从源码构建（需 Rust 1.89 或更新）。支持 macOS 与 Linux 的 x86_64 和 arm64，Linux 提供 glibc 构建，glibc 低于 2.35 时自动使用静态 musl 构建；不支持 Windows。会话与配置存放在 ~/.openmax/。

主要依赖

预编译安装无需 Rust 工具链；从源码构建需要 Rust 1.89 或更新。使用 npm/bun 安装路径时需要 PATH 上有 Node.js。需要自行配置模型端点：base_url、model 和 context_tokens 三项未配置前 Open Max 拒绝开始对话轮次，端点须返回结构化 API tool_calls 才能使用工具，本地服务器需配置模型的工具解析器和聊天模板。

使用限制

项目自述为早期软件（early software）。Windows 不支持。不使用结构化 tool_calls 的端点无法使用工具，助手文本中的调用标记只会作为文本显示而不会执行。单次响应限制为 16 MiB 和 128 次工具调用。内置文件工具受项目根目录路径限制，但 bash、外部 TOML 工具和 hooks 是原生进程，不受该路径限制，会继承主机的文件系统、环境变量、凭证和网络访问。权限、审批与 mutating 元数据只控制调度与用户体验，不是操作系统级隔离。不包含 MCP 宿主、嵌套 agent 调度器、计划模式、后台任务产品、内置 TODO 数据库、可绑定键引擎、可插拔压缩器或 TUI 插件 ABI。官方未说明 API 成本与硬件要求。

许可证

MIT

最近推送

2026-10-06 14:02

资料检查：2026-10-07 07:00 · 卡片整理：2026-10-07 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容

职业应用

程序员

在项目目录中运行终端编程 Agent，使用内置的 list_dir、read_file、write_file、edit_file、glob、grep、bash 工具进行代码编写、审查、测试和排错；通过 TOML 工具、SKILL.md 技能、提示模板和 hooks 扩展工作流，并用 --recall 检索历史会话与记忆。

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证