<div align="center" <a href="https://octomind.run" target="blank" <img src="assets/logo.svg" width="640" alt="Octomind — AI Coding Agent Runtime" / </a <br /<br / <strongThe CLI-first AI coding agent runtime.</strong<br / <emPipe it, schedule it, embed it. One binary, multiple model providers, MCP-native — built for autonomous work, not just chat.</em <br /<br /
<br /
Documentation · Tap Registry · Website </div
---
Octomind is an open-source AI agent client: the model calls MCP tools to do real work — read and write files, run shells, search code, delegate to sub-agents. The same runtime supports several entry points: the same session runs interactively, piped through stdin, as a background daemon, over WebSocket, or as an ACP sub-agent inside another agent's stack. Models, tools, roles, guardrails, budgets — all of it is TOML, no framework code.
# Interactive
octomind run developer:general
# Piped — CI, scripts, automation
echo "Explain the auth module" | octomind run developer:general --format plain
# Daemon — long-running; send from another terminal on the same machine
echo "watch the build" | octomind run --name watcher --daemon --format jsonl
octomind send --name watcher "run the test suite"Table of Contents
- Quick Start
- Benchmarks — Real PRs, Held-Out Tests
- Why Octomind?
- One Binary, Five Surfaces
- Guardrails — Policy as Code
- Cost as a Control Plane
- Sessions That Stay Sharp at Hour 4
- Intent-Driven Context
- Specialists & Taps
- Built-in MCP Tools
- Power Users — Roles, Workflows, Layers
- Installation
- Configuration
- Architecture
- Contributing
- Documentation
- License
---
Quick Start
# Install (macOS & Linux) — single Rust binary; taps install their own tool dependencies
curl -fsSL https://raw.githubusercontent.com/muvon/octomind/master/install.sh | bash
# Sign in — models included, no API keys to manage
octomind login
# Start with a specialist — first use may install tools and request credentials
octomind run developer:general Octomind v0.50.1
Role: developer:general · Model: octohub:auto
~/your/project
> _You're in a session with an agent that can read your code, run commands, edit files, and grow capabilities as needed. Plain-line interface with markdown rendering and shell completions — no TUI to learn, works over SSH, in tmux, in CI logs.
octomind login connects you to Octomind Cloud — a subscription that includes model access through the octohub gateway, so there's nothing to configure. Prefer your own keys? Skip login entirely and bring any provider: OpenRouter, Anthropic, OpenAI, DeepSeek, Ollama, and more. Cloud is the baseline; BYOK is always a first-class path.
developer:general (and lawyer:sg, doctor:blood, …) come from the built-in default tap muvon/tap, not your local config. The config's own default tag is assistant:concierge, so plain octomind run starts that. The banner above is illustrative (the real one renders a pixel icon to the left of the text block).
Other installs: cargo install octomind (Rust 1.95+) or build from source.