Traditional Development Workflow

❌ Manual, repetitive development tasks
❌ Complex CLI tools with steep learning curves
❌ Separate indexing and search systems
❌ Context switching between tools
❌ Limited AI provider options
❌ No autonomous task execution

Octomind Approach

✅ Autonomous agentic AI development
✅ Natural language conversations
✅ Built-in development tools via MCP
✅ Session-first architecture with persistence
✅ Multi-provider AI support (6 providers)
✅ Vision support & intelligent automation

How It Works

Instead of learning complex commands, just have a conversation:

You: "How does authentication work in this project?"

AI: [AI analyzes project structure, finds auth-related files, explains implementation]

You: "Add error handling to the login function"

AI: [AI examines login code, implements error handling, shows changes]

You: "Rename 'processData' to 'processUserData' across all files"

AI: [AI finds all occurrences, performs batch edit across multiple files]

You: "/image screenshot.png
What's wrong with this UI layout?"

AI: [AI analyzes the image, identifies layout issues, suggests CSS fixes]

You: "agent_context_gatherer(task=\"Analyze the authentication system architecture\")"

AI: [Routes task to specialized context gathering AI agent with development tools]

You: "/done"

AI: [Finalizes task with memorization, summarization, and auto-commit. Shows: $0.02 spent, 3 requests, 5 tool calls]

Core Features

🤖

Autonomous Agentic AI

Intelligent agents that understand context, execute complex tasks autonomously, and route work to specialized AI layers for optimal results.

🎯

Session-First Architecture

Everything happens in persistent AI conversations. Save, resume, and organize development sessions with intelligent context management and continuation.

🖼️

Multimodal Vision Support

Analyze images, screenshots, diagrams, and UI layouts with AI across all 6 providers. Perfect for debugging visual issues and design analysis.

🛠️

Built-in Development Tools

File operations, code analysis, shell commands, and more through MCP protocol integration. No external dependencies or complex setup required.

🌐

Multi-Provider AI Support

OpenRouter, OpenAI, Anthropic, Google, Amazon, Cloudflare. Route different tasks to optimal models for cost efficiency and quality.

💰

Intelligent Cost Optimization

Real-time usage tracking, 2-marker cache system, smart model routing, and detailed reporting to optimize costs without sacrificing quality.

Built-in MCP Tools

agent_<name>

Autonomous AI agents for specialized tasks: code review, debugging, context gathering, and more

text_editor

Smart file operations with batch editing, line-precise modifications, and undo support

shell

Terminal commands with foreground/background execution and process management

ast_grep

AST-based code search and refactoring with semantic understanding across languages

semantic_search

Intelligent codebase search (works best with octocode MCP for enhanced results)

web_search

Research and documentation lookup via Brave Search API integration

🚀 Works Best with Octocode MCP

Octomind integrates seamlessly with octocode MCP server for semantic codebase search and enhanced code understanding. Get the most out of your AI development workflow.

Powerful Session Commands

Rich CLI interface with intelligent commands for autonomous development:

🎯 Task Management

/done

Finalize task with memorization, summarization, and auto-commit

/run <command>

Execute configured layer-based workflows

/layers

Toggle layered processing on/off

🖼️ Multimodal & Context

/image <path>

Attach images for AI analysis (PNG, JPEG, GIF, WebP, BMP)

/context [filter]

Display session context with filtering (all, assistant, user, tool)

/cache

Mark cache checkpoint for cost savings

📊 Monitoring & Control

/report

Generate detailed usage report with cost breakdown

/info

Display token usage and costs in real-time

/model [model]

View or change current AI model dynamically

💡 Autonomous Session Management

Sessions automatically manage context, optimize costs, and provide intelligent continuation. Resume any session exactly where you left off with full context preservation.

Ultimate Flexibility

Template-Based Configuration

All defaults in config-templates/default.toml. No hardcoded values, complete customization possible.

Role-Based Access

Developer (full tools) vs Assistant (chat only). Create custom roles for specific workflows.

Layered Processing

Route tasks through specialized AI layers: task_refiner → task_researcher → developer. Use cheaper models for simple tasks.

Autonomous Agents

agent_<name>(task="...") MCP tools route tasks to specialized AI agents for focused, autonomous processing.

Custom Commands

/run <command> executes configured layer-based workflows. /done finalizes tasks with auto-commit.

Intelligent Cost Control

Spending thresholds, smart model routing, 2-marker caching, and detailed reporting to optimize costs while maintaining quality.

Supported AI Providers

Provider	Format	Features
OpenRouter	`openrouter:provider/model`	Multi-provider access, caching, vision models
OpenAI	`openai:model-name`	Direct API, cost calculation, GPT-4o vision
Anthropic	`anthropic:model-name`	Claude models, caching, Claude 3+ vision
Google	`google:model-name`	Vertex AI, Gemini 1.5+ vision support
Amazon	`amazon:model-name`	Bedrock models, AWS integration, Claude vision
Cloudflare	`cloudflare:model-name`	Edge AI, fast inference, Llama 3.2 vision

Built for Effectiveness

🤖

Autonomous Execution

AI agents that understand context and execute complex development tasks without constant supervision.

⚡

Zero Setup

No indexing, no complex configuration. Install and start autonomous development immediately.

🎯

Octocode Ready

Works best with octocode MCP for semantic codebase search and enhanced understanding.

🖼️

Vision Intelligence

Analyze screenshots, diagrams, and UI layouts across all 6 AI providers for comprehensive visual debugging.

💡

Smart Model Routing

Route simple tasks to cheaper models, complex analysis to premium models. Maximize efficiency and cost savings.

🔧

Configuration-Only Tools

Create new capabilities, agents, and workflows through configuration alone. No code changes needed.

Quick Start

Install Octomind

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

Set API Key

export OPENROUTER_API_KEY="your_key"

Start Coding

octomind session

Alternative Installation Methods

# Build from source
						cargo install --git https://github.com/muvon/octomind.git

						# Download from releases
						# See: https://github.com/muvon/octomind/releases

Open Source & Community

Apache 2.0 License

Free and open source software. Use, modify, and distribute freely.

Built with Rust

Performance, safety, and reliability. Cross-platform support for macOS, Linux, and Windows.

Community Driven

Contributions welcome! Help improve AI-powered development tools for everyone.

📦 GitHub Repository 🐛 Report Issues 📖 Documentation 📦 Crates.io