Muvon/octomind

What is it?

Key features

• 01Interactive, piped, daemon, WebSocket and ACP modes share one session engine.
• 02Guardrails in TOML deny tool calls, inject hook output and run post-turn validators.
• 03MCP client supports stdio and Streamable HTTP servers, including OAuth.
• 04Roles and workflows set per-role models, prompts, tools and multi-step pipelines.
• 05Taps install packaged specialist agents and their tool dependencies on first use.
• 06Works with OpenRouter, Anthropic, OpenAI, DeepSeek and Ollama models.

Use cases

• Running a coding agent unattended in CI pipelines or scheduled jobs.
• Driving a long-running background agent that receives messages from a shell.
• Embedding a coding agent as a sub-agent inside another editor or agent stack.
• Enforcing command and file policies on agent actions without manual approvals.

Quick start

1. 1

   Install with Homebrew (macOS)

   brew install muvon/tap/octomind
2. 2

   Or install with Cargo (Rust 1.95+)

   cargo install octomind
3. 3

   Sign in to Octomind Cloud for model access, or export your own provider key instead

   octomind login
4. 4

   Run a specialist in your project directory

   octomind run developer:general

Things to know

• !Model access needs either an Octomind Cloud login or your own provider API key.
• !The specialist roles come from a separate tap registry and may install tools and ask for credentials on first run.

Topics

FAQ

What is octomind?

A CLI-first open-source AI coding agent runtime that works with any model via MCP tools, interactively, piped, as a daemon, or over WebSocket/ACP. Octomind gives an LLM real access to a code repository through MCP tools: it can read and write files, run shell commands, search code, and delegate work to sub-agents. The same session engine runs interactively in a terminal, piped through stdin for CI and scripts, as a background daemon that accepts messages from another terminal, over WebSocket, or as an ACP sub-agent inside another agent or editor.

Is octomind free to use? What license does it have?

octomind is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.

Is octomind still maintained?

Actively maintained. The last commit to octomind was on Oct 20, 2026.

What can I use octomind for?

Running a coding agent unattended in CI pipelines or scheduled jobs. Driving a long-running background agent that receives messages from a shell. Embedding a coding agent as a sub-agent inside another editor or agent stack. Enforcing command and file policies on agent actions without manual approvals.

How do I install octomind?

Install with Homebrew (macOS): brew install muvon/tap/octomind Or install with Cargo (Rust 1.95+): cargo install octomind Sign in to Octomind Cloud for model access, or export your own provider key instead: octomind login Run a specialist in your project directory: octomind run developer:general

Where can I get octomind?

The source code and installation instructions are on GitHub: https://github.com/Muvon/octomind