Octomind – トークンを節約するオープンソースAIハーネス、静的なRust製
Octomind – open-source AI harness that saves your tokens, static rust (github.com)
要約
Octomindは、LLMにリポジトリへの実際のアクセス権を与え、ファイル読み書き、シェル実行、コード検索などを可能にするCLIファーストのAIコーディングエージェントランタイムです。対話型、パイプ処理、デーモン、WebSocket、サブエージェントなど、様々な方法で利用でき、ポリシーをコードとして管理し、実PRでの実績やコスト効率に優れています。
全文翻訳
Octomind – open-source AI harness that saves your tokens, static rust
[画像: Octomind — open-source AI coding agent runtime]
The CLI-first AI coding agent runtime.
Pipe it, schedule it, embed it. One binary, any model, MCP-native —
built for autonomous work, not just chat.
[画像: CI] [画像: Crates.io] [画像: Coverage] [画像: License] [画像: Stars]
Website · Docs · Tap Registry · Benchmarks · Issues
[画像: Octomind mascot: a pixel-art purple octopus with cyan eyes and waving tentacles]
Octomindは、CLIファーストのAIコーディングエージェントランタイムです。MCPツールを介して、LLMにリポジトリへの実際のアクセス権(ファイルの読み書き、シェルの実行、コードの検索、サブエージェントへの委任など)を提供します。同じセッションエンジンは、対話型、標準入力からのパイプ処理、バックグラウンドデーモン、WebSocket経由、または他のエージェントのスタック内のACPサブエージェントとして機能します。
# Interactive
octomind run developer:general
# Piped — CI, scripts, automation
echo "Explain the auth module" | octomind run developer:general --format plain
# Daemon — keep it alive, talk to it from another terminal
echo "watch the build" | octomind run --name watcher --daemon --format jsonl
octomind send --name watcher "run the test suite"
Why Octomind?
ほとんどのコーディングエージェントは、人間が画面を見ていることを前提としています。Octomindは、あなたが離れた後も継続する作業のために構築されています。
- Policy as code, not approval popups. 決定論的なガードレール — 事前呼び出しガード、結果後フック、ターン後バリデーター — はTOMLとスクリプトに存在するため、CI、デーモン、スケジュール実行で機能します。
- Proven on real PRs. 最も近い競合他社よりも低コストで、25件のホールドアウトタスクのうち24件を解決しました。ベンチマークを参照してください。
- Ready-made specialists.
octomind run developer:generalは、タップからパッケージ化されたエージェント(プロンプト、モデル、MCPサーバー、ツール権限)を取得します。独自のものを1つのリポジトリで公開できます。 - Sessions that stay sharp. 適応的な圧縮により、タスク知識とライブ交換を維持しながら、長いタスクを進行させます。
- Any model, any budget. Octomind Cloudまたは独自のキー(OpenRouter、Anthropic、OpenAI、DeepSeek、Ollamaなど)を使用し、ロールごとにモデルを選択し、リクエストごとおよびセッションごとに支出しきい値を設定します。しきい値を超えたリクエストは停止します。ターミナルセッションでは、セッションしきい値に達すると続行する前にy/Nを求めますが、非対話的な
octomind runは終了コード75で停止します。 - One config. モデル、ツール、ロール、ガードレール、予算:すべてTOMLで、フレームワークコードはありません。
Quick Start
1. Install (macOS, Linux):
curl -fsSL https://raw.githubusercontent.com/muvon/octomind/master/install.sh | bash
Windowsでは、PowerShellで:
irm https://raw.githubusercontent.com/muvon/octomind/master/install.ps1 | iex
macOSでは、Homebrewでもインストールできます:
brew install muvon/tap/octomind
2. Get model access. 最速の方法はOctomind Cloudで、モデルが含まれており設定不要です:
octomind login
独自のプロバイダーキーを使用したいですか?ログインをスキップしてキーをエクスポートし(OPENAI_API_KEY、ANTHROPIC_API_KEY、DEEPSEEK_API_KEYも同様)、Model accessに従って設定で指定します:
export OPENROUTER_API_KEY="your_key"
3. Run a specialist in your project:
cd ~/your/project
octomind run developer:general
これで、コードを読み取り、コマンドを実行し、ファイルを編集できるエージェントとのセッションに入りました。インターフェースはMarkdownレンダリング付きのプレーンラインプロンプトです。学習すべきTUIはないため、SSH、tmux、CIログで機能します。スペシャリストを初めて実行する際に、ツールがインストールされ、認証情報が求められる場合があります。
developer:generalは、ローカル設定ではなく、デフォルトのタップmuvon/tapから取得されます。プレーンなoctomind runは、設定のデフォルトロールであるassistant:conciergeを開始します。
記録されたバグ修正デモを試してみてください。2つのテストが失敗し、エージェントが修正し、独立したテストが再実行されます。
Benchmarks
octobenchで測定され、Python、PHP、Rust、C++、JavaScript全体のマージされたプルリクエストから収集された25のタスクに対して行われました。各エージェントは修正前のリポジトリで動作し、マージされた修正からのホールドアウトテストが合格または不合格を決定します。これらは2026年7月30日の公開結果であり、このチェックアウトの測定ではありません。
| solved | judge Σ / 2500 | cost | wall time | |
|---|---|---|---|---|
| octomind + glm-5.2 | 24/25 | 2264 | $63.43 | 3.6h |
| claude code + claude-opus-5 | 23/25 | 2262 | $81.79 | 6.7h |
| codex + gpt-5.6-sol | 21/25 | 2127 | $14.86 | 1.0h |
| opencode + glm-5.2 | 19/25 | 2093 | $129.54 | 3.3h |
- The harness matters. opencodeは同じモデルとエンドポイントを使用しましたが、octomindはコストの約半分で24件対19件を解決しました。4つのエージェントすべてがチューニングなしで標準的な呼び出しを実行したため、これは個々の機能ではなく、ハーネス全体を測定します。
- Worst-case pricing, still ahead. glm-5.2はプロンプトキャッシュなしで実行され、Opusはコンテキスト再読み取りの約97%をキャッシュレートで請求しましたが、octomindは解決数、コスト、ウォールタイムで依然としてリードしていました。
- Reproducible. ケースごとのテーブル、アーティファクト、再現ガイド:BENCHMARK.md。背景:ブログ投稿。
Guardrails: Policy as Code
リポジトリに.agents/guardrails.tomlをドロップしてください。ランタイムは、コンパイルするコードやインストールするプラグインなしで、それを決定論的に強制します。
# Pre-call deny — block a class of calls before they execute
[[guard]]
match = "shell(command=^rm\s+-rf?)"
message = "rm -rf blocked."
# Conditional rule — only fires after the agent ran git status this session
[[guard]]
match = "shell(command=git push)"
when = ["+shell(command=git status)"]
message = "Review changes before pushing."
| Layer | When it runs | What it does |
|---|---|---|
| Guards | Before a tool call | Deny by capability, argument regex, and session history. A match returns a denial instead of executing the call. |
| Hooks | After a tool result | A non-zero exit injects stdout into the agent's inbox — lint and format failures become automatic corrections without restarting the turn. |
| Validators | After a turn | Scripts the agent reads on its next turn. This replaces "approve this change?" prompts in autonomous loops. |
フックとバリデーターのスクリプト例:Guardrails guide。
Five Ways to Run It
同じセッションエンジンを、ワークフローのニーズに合わせて公開します。
| Surface | Use it for | Docs |
|---|---|---|
| Interactive CLI | Daily work, any domain | Sessions |
Piped (--format plain / jsonl) | CI/CD, shell scripts, automation | CLI reference |
Daemon + send | Background agents, continuous monitoring | Daemon & hooks |
WebSocket (octomind server) | IDE plugins, dashboards, integrations | WebSocket server |
ACP (octomind acp) | Sub-agent inside another agent or editor | ACP protocol |
機械可読の結果が必要ですか? --schema schema.jsonを渡して、最終的な応答をJSONスキーマに制約します(構造化出力サポートのあるモデルが必要です)。Structured outputを参照してください。
Features
| Feature | What you get | Learn more |
|---|---|---|
| Specialists & taps | Packaged agents with model, prompt, MCP servers, and permissions; installs their tool dependencies on first use | Tap system |
| Roles | Per-role model, temperature, system prompt, tools | Roles |
| Workflows | Multi-step pipelines, each step with its own model and toolset | Workflows |
| MCP client | stdio and Streamable HTTP servers, with OAuth; enable/disable servers mid-session | MCP tools |
| Intent-driven context | Skills and capabilities activate on demand, keeping context small | Skills |
| Local project tools | Executable scripts in .agents/tools/ auto-register as tools | Local tools |
| Supervisor & learning | External planning and gating; file-backed learning records | Supervisor, Learning |
| Sandbox | --sandbox restricts filesystem writes to the working directory | Config reference |
| Token efficiency | Cache-aware accounting and compaction | Token efficiency |
Specialists
octomind run developer:general # general dev, language skills auto-activate
octomind run doctor:blood # blood-test interpretation specialist
octomind run lawyer:sg # legal specialist
スペシャリストを実行すると、タップからマニフェストが取得され、必要なバイナリがインストールされ、認証情報が解決され、適切なMCPサーバーが起動され、セッションが開かれます。
独自のものをビルドして登録します:
octomind tap init yourteam/my-tap # scaffold, validate, git-init, and register locally
octomind tap yourteam/my-tap # on another machine, after publishing to GitHub
octomind-プレフィックスは自動的に追加されます:yourteam/my-tapはリポジトリyourteam/octomind-my-tapにマッピングされます。
Installation
| Method | Command |
|---|---|
| Install script (recommended) | `curl -fsSL https://raw.githubusercontent.com/muvon/octomind/master/install.sh |
| Install script (Windows PowerShell) | `irm https://raw.githubusercontent.com/muvon/octomind/master/install.ps1 |
| Homebrew (macOS) | brew install muvon/tap/octomind |
| Scoop (Windows) | scoop bucket add muvon https://github.com/Muvon/scoop-bucket then scoop install muvon/octomind |
| Cargo (Rust 1.95+) | cargo install octomind |
| Docker | docker run --rm ghcr.io/muvon/octomind --help |
| From source | git clone https://github.com/muvon/octomind.git && cd octomind && cargo build --release |
インストールスクリプトはOSとアーキテクチャ(x86_64/aarch64のLinuxおよびmacOS)を検出し、~/.local/bin/にインストールします。--install-dir <DIR>を渡すか、OCTOMIND_INSTALL_DIRを設定して上書きできます。Windows(x86_64/aarch64)では、install.ps1は%LOCALAPPDATA%\octomind\binにインストールし、ユーザーのPATHに追加します。OCTOMIND_INSTALL_DIRとOCTOMIND_VERSIONも尊重します。install.shはGit BashまたはMSYS2からでも機能します。
Command not found? インストールディレクトリをPATHに追加してください:
export PATH="$HOME/.local/bin:$PATH"
ソースからのビルドにはprotocが必要です。Building from sourceでOSごとの前提条件を確認してください。
Verify:
octomind --version
octomind config # generate the default config
octomind run # start your first session
シェル補完:octomind completion <bash|zsh|fish|elvish|powershell>。
Model access
Octomind Cloud — octomind login(gh auth loginのようなデバイスコードサインイン)は、ローカルにゲートウェイキーを保存します。デフォルト設定はすでにoctohub:autoを使用しています。Learn more。
Bring your own key — プロバイダーの環境変数(OPENROUTER_API_KEY、OPENAI_API_KEY、ANTHROPIC_API_KEY、DEEPSEEK_API_KEYなど)を設定し、モデルテーブルをそれにポイントします。スーパーバイザーと圧縮プロファイルもデフォルトでoctohub:autoなので、すべて更新してください:
[model]
name = "openrouter:google/gemini-2.5-flash"
[supervisor.model]
name = "openrouter:google/gemini-2.5-flash"
[compression.model]
name = "openrouter:google/gemini-2.5-flash"
プロバイダーの詳細とロールごとのオーバーライド:Providers & models。
Configuration
設定はmacOSおよびLinuxでは~/.local/share/octomind/config/config.tomlに、Windowsでは%LOCALAPPDATA%/octomind/config/の下にあります。OCTOMIND_DATA_DIRを設定してデータルートを上書きできます。
octomind config --show # view current config
octomind config --validate # validate config
-cで単一の実行のために任意の値を上書きできます:
octomind run -c supervisor.enabled=false
フルリファレンス:Configuration reference · Environment variables。
Session commands
| Command | Description |
|---|---|
/help | Show all commands |
/info | Token usage and costs |
/model anthropic:claude-haiku-4-5 | Switch model mid-session |
/role developer:general | Switch to a configured role or tap tag |
/new Review auth | Start a fresh session (title optional) |
/done | Force context compression and start background learning extraction when enabled |
/exit | Exit the session |
フルリスト:Session commands。
Telemetry
Octomindは匿名使用状況を報告します:どのコマンド、ツール、モデルが使用されたか、タイミング、トークン数、エラーの種類。コード、プロンプト、ファイルパス、ツール引数、環境値は送信しません。3つの方法のいずれかでオプトアウトできます:
export DO_NOT_TRACK=1 # the cross-tool standard, honored first
export OCTOMIND_TELEMETRY=0 # for subsequent commands in this shell
# or set `telemetry = false` in config.toml
正確なフィールドリスト:Telemetry。
Documentation
フルインデックス:doc/README.md · ホスト:octomind.run/docs
Contributing
最も影響力のある貢献はコードではありません — スペシャリストエージェントです。心臓専門医がdoctor:medicationsを公開する。税理士がlawyer:usを公開する。セキュリティ研究者がsecurity:owaspを公開する。TOMLファイル1つで、その問題に直面している誰もがスペシャリストグレードのAIを得られます。
コード貢献も歓迎します。プッシュする前にフックを設定し、ゲートを実行してください:
pip install pre-commit && pre-commit install
make dev # fmt + clippy + test
コミットはConventional Commitsに従います。フルガイド、アーキテクチャ概要、コード規約:CONTRIBUTING.md · 内部:Architecture。
コミュニティ参加はCode of Conductに従います。脆弱性はsecurity policyを使用してプライベートに報告してください。
License
Apache License 2.0 — LICENSEを参照してください。