Repolode
Muvon

Muvon/octomind

命令行优先的开源 AI 编程代理运行时,支持任意模型和 MCP 工具,可交互、管道、守护进程或通过 WebSocket 使用。

可替代:Claude Code

Star
175
Fork
32
未关闭 Issue
38
最近提交
13小时前

这是什么?

Octomind 通过 MCP 工具让大模型真正接入代码仓库,可以读写文件、执行 shell 命令、搜索代码,并把任务委派给子代理。同一套会话引擎既可以在终端中交互使用,也可以通过标准输入管道接入 CI 和脚本,还能作为后台守护进程接收另一个终端发来的消息,或通过 WebSocket、ACP 作为其他代理或编辑器的子代理运行。

行为规则通过 TOML 配置。确定性的 guardrails 可以在工具调用执行前拒绝,在工具结果返回后注入 lint 或格式化输出,并在每轮结束后运行校验脚本,因此自动化任务无需依赖人工审批弹窗。角色和工作流可分别设置模型、提示词、工具集和预算,打包好的专业代理则可以从以 GitHub 仓库形式存在的 tap 中安装。

模型可以使用 Octomind Cloud,也可以接入自己的 API Key,支持 OpenRouter、Anthropic、OpenAI、DeepSeek、Ollama 等。项目使用 Rust 编写,可通过安装脚本、Homebrew、Cargo 或 Docker 获取单一可执行文件,采用 Apache 2.0 许可证。

核心功能

  • 01交互、管道、守护进程、WebSocket 和 ACP 五种方式共用同一套会话引擎。
  • 02通过 TOML 配置 guardrails,可拒绝工具调用、注入钩子输出并在每轮后运行校验脚本。
  • 03MCP 客户端支持 stdio 和 Streamable HTTP 服务器,并支持 OAuth。
  • 04角色和工作流可为每个角色设置模型、提示词和工具,并组成多步骤流程。
  • 05Tap 机制可安装打包好的专业代理及其工具依赖。
  • 06兼容 OpenRouter、Anthropic、OpenAI、DeepSeek、Ollama 等模型提供方。

适用场景

  • 在 CI 流水线或定时任务中无人值守地运行编程代理。
  • 运行长期后台代理,通过命令行持续向其发送任务。
  • 将编程代理嵌入其他编辑器或代理系统中作为子代理。
  • 在不依赖人工审批的情况下,对代理的命令和文件操作设置策略限制。

快速上手

  1. 1

    使用 Homebrew 安装(macOS)

    brew install muvon/tap/octomind
  2. 2

    或使用 Cargo 安装(需要 Rust 1.95+)

    cargo install octomind
  3. 3

    登录 Octomind Cloud 获取模型访问权限,或改为导出你自己的模型服务商密钥

    octomind login
  4. 4

    在项目目录中运行一个专用代理

    octomind run developer:general

使用前须知

  • 模型访问需要登录 Octomind Cloud,或自行提供模型服务商的 API 密钥。
  • 专用代理角色来自单独的 tap 仓库,首次运行时可能会安装工具并要求提供凭据。

标签

常见问题

octomind 是什么?
命令行优先的开源 AI 编程代理运行时,支持任意模型和 MCP 工具,可交互、管道、守护进程或通过 WebSocket 使用。 Octomind 通过 MCP 工具让大模型真正接入代码仓库,可以读写文件、执行 shell 命令、搜索代码,并把任务委派给子代理。同一套会话引擎既可以在终端中交互使用,也可以通过标准输入管道接入 CI 和脚本,还能作为后台守护进程接收另一个终端发来的消息,或通过 WebSocket、ACP 作为其他代理或编辑器的子代理运行。
octomind 可以免费使用吗?用的什么许可证?
octomind 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
octomind 还在维护吗?
活跃维护中。octomind 最近一次提交是在 2026年10月20日。
octomind 适合用来做什么?
在 CI 流水线或定时任务中无人值守地运行编程代理。 运行长期后台代理,通过命令行持续向其发送任务。 将编程代理嵌入其他编辑器或代理系统中作为子代理。 在不依赖人工审批的情况下,对代理的命令和文件操作设置策略限制。
octomind 怎么安装和运行?
使用 Homebrew 安装(macOS): brew install muvon/tap/octomind 或使用 Cargo 安装(需要 Rust 1.95+): cargo install octomind 登录 Octomind Cloud 获取模型访问权限,或改为导出你自己的模型服务商密钥: octomind login 在项目目录中运行一个专用代理: octomind run developer:general
在哪里获取 octomind?
源代码和安装说明在 GitHub 上:https://github.com/Muvon/octomind

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目