Octomind 是一个开源 AI 代理客户端及代理运行时。其核心定位是让模型调用 MCP 工具完成实际工作——读写文件、运行 shell、搜索代码、委派给子代理。同一套运行时支持多种入口：同一会话可以交互式运行、通过 stdin 管道传入、作为后台守护进程、通过 WebSocket 服务，或作为 ACP 子代理嵌入到其他代理栈中。模型、工具、角色、护栏和预算全部使用 TOML 配置，无需框架代码。
主要能力
一、单一二进制，五种运行界面 Octomind 以单一二进制形式交付。命令行界面采用纯文本行模式，支持 Markdown 渲染和 shell 补全，无需学习 TUI，可通过 SSH、tmux 和 CI 日志使用。octomind run 的位置参数是角色或 tap 标签，而非消息。管道 stdin 以非交互方式运行，默认使用 plain 格式，可通过 --format plain 或 --format jsonl 选择输出格式。在终端中，不带 --format 会启动交互式会话。server 和 acp 不接受 --format。--daemon 保持进程存活但不与终端分离，需在另一终端使用 octomind send。
二、接入模型的方式 可通过 octomind login 连接 Octomind Cloud——该订阅包含经由 octohub 网关的模型访问，无需额外配置。也可以完全跳过登录，自带任意提供商密钥：OpenRouter、Anthropic、OpenAI、DeepSeek、Ollama 等。Cloud 是基线方案，BYOK 始终是一等路径。
三、专家角色与 Tap 内置默认 tap 为 muvon/tap，提供 developer:general、lawyer:sg、doctor:blood 等专家。配置自身的默认标签是 assistant:concierge，因此直接运行 octomind run 会启动该角色。每个 tap 是一个 Git 仓库，每个代理是一个 TOML 文件。可通过 octomind run developer:general 启动专家。用户可发布自己的 tap，例如 doctor:medications、lawyer:us、devops:terraform。
四、护栏——政策即代码 在仓库中放入 .agents/guardrails.toml，运行时会确定性地执行。包括： Guards（预调用拒绝规则，可按 capability(arg_name=regex) 匹配、按历史记录门控 +used / -unused、要求已加载能力 has = [...]）；Hooks（工具结果后运行的脚本，非零退出会把 stdout 注入代理收件箱作为用户消息）；Validators（轮次后脚本，按 when 历史过滤检查上一轮以来的调用，输出包裹在 <validation> 块中供代理下一轮读取）。该 DSL 将 capability、arg-regex、history、role、result-regex 组合在一个声明式文件中，无需编译代码或安装插件，适用于 CI、守护进程、定时任务、ACP 子代理。
五、成本控制 支持跨多个提供商（OpenRouter、OpenAI、Anthropic、Google、DeepSeek、Amazon Bedrock、Cloudflare 等，通过 octolib）按角色和按工作流步骤选择模型。可在会话中用 /model anthropic:claude-haiku-4-5 中途切换模型，会话总计包含模型切换的用量。提供按请求和按会话的实时成本跟踪，以及缓存感知的令牌核算（cache_read_tokens、cache_write_tokens 与输入/输出分开）。可配置请求和会话阈值，两者默认关闭，属延续性检查而非预付费计费限制。
六、长任务上下文保持 自适应压缩引擎自动运行：缓存感知（在付出压缩成本前计算是否值得）、增长感知（根据实测增长和上下文上限调整压缩目标）、结构保留（保留关键知识、选定分析发现和实时交换）、计划感知（监督者在外部跟踪复杂工作）。会话可持久化：octomind run --name my-feature 边运行边保存，octomind run --resume my-feature 或 --resume-recent 恢复。在任务边界使用 /done 强制压缩并启动后台学习。
七、意图驱动上下文 角色决定启动时加载的工具，任务发展过程中可激活额外技能和能力。技能注入指令并加载所需能力，保持激活直到被遗忘或在任务边界清除。激活机制包括：语义规则（内部嵌入模型将请求与技能的语义短语和能力触发短语评分）、手工规则（技能作者可将激活固定到文件名、文件内容或精确短语）、语义接近平局时弃权、校准为跳过而非猜测。激活技能时会同时启用所需的能力服务器。停用的技能在压缩时被丢弃，内容可在下次激活时恢复。
八、MCP 工具 Octomind 是支持 stdio 和 Streamable HTTP 服务器的 MCP 客户端，支持 OAuth，并在内部路由内置工具。文件系统工具（通过 octofs）：view、text_editor、batch_edit、extract_lines、shell、workdir。Brain（通过 octobrain）：memorize、remember、forget、knowledge 用于持久记忆和知识索引。core、orchestration、runtime、agent 是默认配置中的四个内置 MCP 服务器。本地项目工具：将带 # @description 头的可执行脚本放入 <workdir>/.agents/tools/，会自动发现为该项目 MCP 工具。
九、高级配置 支持按角色的模型覆盖、系统提示、MCP 服务器和工具权限；Layers（ACP 子进程阶段，也用于 /run 命令）；Guardrails（确定性策略和输入管道）；Workflows（顺序、并行、条件和循环步骤的任务运行器）；Supervisor（带外规划、循环/无进展检测、完成验证、工具输出浓缩和跨会话学习）。全部为 TOML，无需代码。
安装方式
一行安装命令：自动检测操作系统和架构，默认安装到 ~/.local/bin/。支持 macOS、Linux 和 Windows；Windows 上需从 Git Bash 或 MSYS2 运行。代理是一个 Rust 二进制文件，外部 MCP 工具有各自的依赖。
cargo install octomind（需要 Rust 1.95+），或从源码构建。
使用 Octomind Cloud：octomind login 进行设备码登录（类似 gh auth login），本地存储服务器签发的 octohub 网关密钥，默认配置已在 [model] 下设置 name = "octohub:auto"。
自带密钥：Octomind 完全开源，可与支持的提供商独立运行，将所选密钥添加到 ~/.bashrc 或 ~/.zshrc。
限制与说明
安装命令可能需要 Rust 1.95+；外部 MCP 工具有各自依赖。成本阈值为延续性检查，提供商调用可能超出配置金额。压缩本身消耗令牌并可能使缓存失效。可用提供商取决于链接到二进制中的 octolib 版本。部分功能细节如 WebSocket 服务器、ACP 协议、守护进程与钩子、结构化输出等，资料中仅提及名称，具体配置要求暂未提供。
