octomind

Octomind is an AI-powered development assistant that runs as an MCP server and provides a flexible, extensible toolchain for coding tasks. It exposes multiple capabilities such as a shell for executing commands, an editor for patching files, a search tool for codebase exploration, and a web search feature for browsing HTML results. You can switch between different AI providers (OpenAI, Anthropic, Google, Amazon, Cloudflare, DeepSeek, and OpenRouter) and plan workflows in a multi-step, gated manner. The server supports interactive sessions, a WebSocket interface for automation and IDE plugins, and a JSONL mode suitable for CI/CD pipelines. To get started, install Octomind, configure your provider key(s), and run the server or session mode to begin interacting with your codebase through the AI.

Once running, you can use the built-in tools to perform common tasks: run shell commands to modify and inspect the project, edit files in batch via the editor, search the codebase with ast_grep patterns, and perform web searches to fetch relevant HTML pages. Use the command syntax and prompts to create multi-step plans, validate them with gates, and apply changes across the repository. The system is designed to be provider-agnostic, letting you mix and match providers as needed and keep an eye on real-time costs.

Prerequisites:

• Rust toolchain installed (rustup, cargo)
• Optional: curl for installation script
• Access to an API key for your preferred provider(s) (OpenRouter, OpenAI, Anthropic, Google, Amazon, Cloudflare, DeepSeek)

Install from the official script or build from source:

1. One-line install (recommended):

curl -fsSL https://raw.githubusercontent.com/muvon/octomind/master/install.sh | bash

2. Build from source (manual):

git clone https://github.com/muvon/octomind.git
cd octomind
cargo build --release

3. Set your API key(s) for the providers you plan to use, for example:

export OPENROUTER_API_KEY="your_openrouter_key"

4. Run the MCP server (example for interactive session):

octomind session

Supported providers include OpenRouter, OpenAI, Anthropic, Google, Amazon, Cloudflare, and DeepSeek.

Tips and common issues:

• Ensure your API keys are set in the environment before starting the server.
• If you switch providers, you can use commands like "/model provider:name" to switch quickly.
• For CI/CD automation, use the JSONL mode: octomind run developer "task" --format=jsonl.
• The server supports multiple run modes (Interactive, WebSocket, JSONL); choose the mode that best fits your workflow.
• If you encounter build errors, verify Rust toolchain is up to date and that you have internet access to fetch dependencies.
• The project emphasizes extensibility via custom commands and prompt templates; consider adding your own layers and workflows for frequent tasks.