Octomind
Octomind is an open-source, CLI-first AI coding agent runtime that lets models call MCP tools to perform real work. It solves the problem of agent CLIs that are chat-only by supporting interactive, piped, daemon, WebSocket, and ACP modes from one binary. It is for developers who need autonomous agents in CI, scripts, or multi-agent systems.
✨ Key features
- One binary with five surfaces: interactive, pipe, daemon, WebSocket, ACP.
- Guardrails as code: deterministic pre-call, post-result, post-turn scripts.
- Cost control: per-role model selection, hard spending caps, cache-aware accounting.
- Intent-driven context: skills activate only when needed.
- Tap registry: packaged specialists as TOML files in Git repos.
- Adaptive compaction keeps sessions sharp at hour 4.
🎯 Use cases
- Run autonomous coding tasks in CI/CD pipelines via piped stdin.
- Deploy background daemons that monitor builds and run tests.
- Embed as a sub-agent in multi-agent systems via ACP protocol.
- Use specialized agents like lawyer:sg or doctor:blood for expert domains.
- Automate code review with guardrails that run tests after edits.
📦 Installation
🧰 Requirements: macOS or Linux; Rust 1.95+ if building from source; optional login to Octomind Cloud for model access, or bring your own API keys.
# Install (macOS & Linux) — single Rust binary, no runtime dependencies
curl -fsSL https://raw.githubusercontent.com/muvon/octomind/master/install.sh | bash
Other installs: cargo install octomind (Rust 1.95+) or build from source.
🚀 Usage
octomind run developer:generalecho "Explain the auth module" | octomind run developer:general --format plainecho "watch the build" | octomind run --name watcher --daemon --format jsonl
octomind send --name watcher "run the test suite"❓ FAQ
How do I install Octomind?
Run the install script with curl, or use cargo install octomind if you have Rust 1.95+.
Do I need to configure API keys?
No, you can octomind login to use Octomind Cloud which includes model access, or skip login and bring your own keys from providers like OpenRouter, Anthropic, OpenAI, etc.
Can I run Octomind non-interactively?
Yes, pipe input via stdin and use --format plain or --format jsonl; it runs once and exits when stdin is not a terminal.
How do I enforce safety policies?
Create a .agents/guardrails.toml file with guard, hook, and validator rules that are enforced deterministically.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.