Skip to content

Release history

muvon/octocode releases

Semantic code indexer with GraphRAG knowledge graph. Index your codebase, search in natural language, and expose everything via MCP so AI agents understand architecture — not just files.

Back to tool Latest release

All releases

8 shown

No immediate action
0.15.0 Mixed

Hybrid search + GraphRAG improvements

Open
0.14.1 Maintenance

Minor fixes and improvements.

Full changelog

🚀 What's Changed

📋 Release Summary

This update enhances overall system stability and performance through significant upgrades to core engine dependencies (9d872d61, 378effe8). Build and deployment processes have also been optimized to ensure faster, more efficient Docker environments (1d6e752a).

🔧 Improvements & Optimizations

  • build: optimize CI and Docker build performance 1d6e752a

🔄 Other Changes

2 maintenance, dependency, and tooling updates not listed individually.

📦 Installation

Quick Install Script (Universal)

curl -fsSL https://raw.githubusercontent.com/Muvon/octocode/main/install.sh | sh

Works on: Linux, macOS, Windows (Git Bash/WSL/MSYS2), and any Unix-like system

Manual Download

| Platform | Architecture | Download |
|----------|--------------|----------|
| Linux | x86_64 (static) | octocode-0.14.1-x86_64-unknown-linux-musl.tar.gz |
| Linux | ARM64 (static) | octocode-0.14.1-aarch64-unknown-linux-musl.tar.gz |
| Windows | x86_64 | octocode-0.14.1-x86_64-pc-windows-msvc.zip |
| Windows | ARM64 | octocode-0.14.1-aarch64-pc-windows-msvc.zip |
| macOS | x86_64 | octocode-0.14.1-x86_64-apple-darwin.tar.gz |
| macOS | ARM64 | octocode-0.14.1-aarch64-apple-darwin.tar.gz |

Using Cargo (from crates.io)

cargo install octocode

Using Cargo (from Git)

cargo install --git https://github.com/Muvon/octocode

Verify Installation

octocode --version
View release on GitHub
0.14.0 Breaking risk
Breaking changes
  • search: unified architecture replaces prior separated search implementation
Notable features
  • AST-based structural code search
  • Code rewrite with AST templates
  • Embedding support for MPNet and Jinabert QK models
Full changelog

🚀 What's Changed

📋 Release Summary

This release introduces a unified search architecture alongside powerful AST-based structural code search and rewriting capabilities (1c33c779, 07fbd5f2, 8abed697). Key improvements include branch-aware delta indexing, automatic repository indexing for MCP, and expanded support for high-performance embedding models (7c515998, a9690903, 09558952). System reliability is further enhanced through strict structured LLM outputs and optimized batch processing with automated retries (fb0196a3, d40f641c, 5739cb1b).

🚨 Breaking Changes

⚠️ Important: This release contains breaking changes that may require code updates.

  • search: unify search and add tests 1c33c779

✨ New Features & Enhancements

  • embeddings: add mpnet and jinabert qk embedding support 09558952
  • server: enhance MCP tool schemas and add new tools 6b7d4e65
  • clear: add commits and graphrag clear modes e793d8d5
  • grep: add code rewrite with AST templates 07fbd5f2
  • grep: add AST structural code search 8abed697
  • indexer: add last segment matching for imports ca7fcd10
  • grep: add AST-based structural code search c15dcddf
  • indexer: add AST-based function call extraction c698904d
  • graphrag: add branch-aware filtering and merging 09e6337c
  • llm: enable strict mode for structured output fb0196a3
  • graphrag: validate description model structured output e4344d71
  • benchmark: add retrieval quality benchmark infrastructure e1095d2d
  • indexer: add retries and improve batching d40f641c
  • mcp: add automatic repository indexing a9690903
  • git: add branch-aware delta indexing 7c515998
  • branding: add project logo to readme fb536f29
  • assets: add svg icon to readme header 7449dece

🔧 Improvements & Optimizations

  • mcp: replace handlers module with rmcp transport bb5f929b
  • docs: standardize LLM config and model format 0c25e456
  • llm: consolidate JSON completion methods 4f2a756d
  • indexer: move LLM structured output validation to index start d5bce043
  • graphrag: use structured JSON output for LLM calls 25d596d9
  • benchmark: clean up config comments ff24fb59
  • mcp: use is_some_and for task check d1469db7

🐛 Bug Fixes & Stability

  • graphrag: detect partial indexing when relationships missing e51fe5fb
  • graphrag: clarify architectural analysis JSON response format d3f9fb96
  • graphrag: clarify JSON response format for file descriptions 872b8ca6
  • clippy: resolve lint warnings in grep and tests c6f80587
  • graphrag: ensure deleted files don't break processing 0c105ffa
  • docs: swap code and docs search mode labels ab4fbc2b
  • graphrag: add error context to batch retry logs b1771ba4
  • graphrag: add retries for batch AI operations 5739cb1b

📚 Documentation & Examples

  • update recommended text embedding model to MiniLM 5d5e7cfb
  • add AI agent workflow docs and MCP setup 50448b99
  • grep: document structural rewrite capability d62fb98b
  • fix anchor links in navigation bar c521f047
  • readme: clarify structural code analysis approach d48033ab

🔄 Other Changes

5 maintenance, dependency, and tooling updates not listed individually.

📦 Installation

Quick Install Script (Universal)

curl -fsSL https://raw.githubusercontent.com/Muvon/octocode/main/install.sh | sh

Works on: Linux, macOS, Windows (Git Bash/WSL/MSYS2), and any Unix-like system

Manual Download

| Platform | Architecture | Download |
|----------|--------------|----------|
| Linux | x86_64 (static) | octocode-0.14.0-x86_64-unknown-linux-musl.tar.gz |
| Linux | ARM64 (static) | octocode-0.14.0-aarch64-unknown-linux-musl.tar.gz |
| Windows | x86_64 | octocode-0.14.0-x86_64-pc-windows-msvc.zip |
| Windows | ARM64 | octocode-0.14.0-aarch64-pc-windows-msvc.zip |
| macOS | x86_64 | octocode-0.14.0-x86_64-apple-darwin.tar.gz |
| macOS | ARM64 | octocode-0.14.0-aarch64-apple-darwin.tar.gz |

Using Cargo (from crates.io)

cargo install octocode

Using Cargo (from Git)

cargo install --git https://github.com/Muvon/octocode

Verify Installation

octocode --version
View release on GitHub
0.13.0 Breaking risk
Breaking changes
  • search: add detail levels for commit results (commit search now requires a `detail` parameter)
Notable features
  • CLI commands diff, explain, and stats
  • AI-powered indexing enhancements: contextual chunk enrichment, quantization support, new embedding providers
Full changelog

🚀 What's Changed

📋 Release Summary

This update overhauls commit search with advanced filtering and introduces new CLI commands for diffing, explaining, and codebase statistics (35017166, 8273af18, 62a79992, b09059bc, ede5c6a8). AI-powered indexing is significantly enhanced with contextual chunking, quantization support, and new embedding providers to improve retrieval accuracy and reliability (4ae6b516, 0a822970, 2f408409, 31c47638, db73bad1, 91490c54). System stability and integration are further improved through an updated MCP server and various fixes to Git operations and relationship mapping (068949b5, 05b8286b, 25ae71f7, 05373ed6).

🚨 Breaking Changes

⚠️ Important: This release contains breaking changes that may require code updates.

  • search: add detail levels for commit results 35017166

✨ New Features & Enhancements

  • search: add commit search and overhaul system 8273af18
  • search: rerank and filter commit results 62a79992
  • cli: add diff, explain, and stats commands b09059bc
  • indexing: improve LLM reliability and retries 4ae6b516
  • indexer: add contextual chunk enrichment 0a822970
  • search: add lazy-loaded commits search ede5c6a8
  • store: add RaBitQ quantization support 2f408409
  • graphrag: enhance node resolution and path finding 31c47638
  • release: Add Info.plist version update for macOS/iOS 32a18ab4
  • models: add OctoHub and Together embedding providers db73bad1
  • models: add OctoHub embedding provider support 91490c54

🔧 Improvements & Optimizations

  • mcp: migrate to official rmcp SDK with stdio and HTTP transports 068949b5
  • release: improve changelog categorization and noise reduction 878df5c7
  • commit: improve AI message synthesis for large diffs 03474689

🐛 Bug Fixes & Stability

  • git: resolve root commit diffing and lints 05b8286b
  • embedding: use asymmetric retrieval types 25ae71f7
  • search: defer similarity filtering on rerank a8584805
  • commit: clarify user guidance role in prompt cd704f62
  • graphrag: correct relationship batch progress counter 05373ed6

🔄 Other Changes

5 maintenance, dependency, and tooling updates not listed individually.

📦 Installation

Quick Install Script (Universal)

curl -fsSL https://raw.githubusercontent.com/Muvon/octocode/main/install.sh | sh

Works on: Linux, macOS, Windows (Git Bash/WSL/MSYS2), and any Unix-like system

Manual Download

| Platform | Architecture | Download |
|----------|--------------|----------|
| Linux | x86_64 (static) | octocode-0.13.0-x86_64-unknown-linux-musl.tar.gz |
| Linux | ARM64 (static) | octocode-0.13.0-aarch64-unknown-linux-musl.tar.gz |
| Windows | x86_64 | octocode-0.13.0-x86_64-pc-windows-msvc.zip |
| Windows | ARM64 | octocode-0.13.0-aarch64-pc-windows-msvc.zip |
| macOS | x86_64 | octocode-0.13.0-x86_64-apple-darwin.tar.gz |
| macOS | ARM64 | octocode-0.13.0-aarch64-apple-darwin.tar.gz |

Using Cargo (from crates.io)

cargo install octocode

Using Cargo (from Git)

cargo install --git https://github.com/Muvon/octocode

Verify Installation

octocode --version
View release on GitHub
0.12.2 New feature
Notable features
  • Indexer stores metadata atomically after batch processing (commit d35ebfb2)
  • Rust toolchain upgraded from 1.92.0 to 1.94.0
  • Dependency octolib bumped to 0.11.0 with related updates
Full changelog

🚀 What's Changed

📋 Release Summary

This release improves indexing reliability and overall system performance. Enhanced metadata handling ensures more consistent code analysis results, while dependency updates provide better stability and compatibility.

🔧 Improvements & Optimizations

  • indexer: atomic metadata storage after batch d35ebfb2

🔄 Other Changes

  • deps: bump octolib to 0.11.0 and update related dependencies 61fb0cd7
  • deps: bump dependency versions in Cargo.lock ec53cb04
  • bump Rust toolchain from 1.92.0 to 1.94.0 2d40e7e6

📊 Release Summary

Total commits: 4 across 2 categories

🔧 1 improvement - Better performance & code quality
🔄 3 other changes - Maintenance & tooling

📦 Installation

Quick Install Script (Universal)

curl -fsSL https://raw.githubusercontent.com/Muvon/octocode/main/install.sh | sh

Works on: Linux, macOS, Windows (Git Bash/WSL/MSYS2), and any Unix-like system

Manual Download

| Platform | Architecture | Download |
|----------|--------------|----------|
| Linux | x86_64 (static) | octocode-0.12.2-x86_64-unknown-linux-musl.tar.gz |
| Linux | ARM64 (static) | octocode-0.12.2-aarch64-unknown-linux-musl.tar.gz |
| Windows | x86_64 | octocode-0.12.2-x86_64-pc-windows-msvc.zip |
| Windows | ARM64 | octocode-0.12.2-aarch64-pc-windows-msvc.zip |
| macOS | x86_64 | octocode-0.12.2-x86_64-apple-darwin.tar.gz |
| macOS | ARM64 | octocode-0.12.2-aarch64-apple-darwin.tar.gz |

Using Cargo (from crates.io)

cargo install octocode

Using Cargo (from Git)

cargo install --git https://github.com/Muvon/octocode

Verify Installation

octocode --version
View release on GitHub
0.12.1 Bug fix

Fixed search issue where zero‑vector embeddings returned no results.

Full changelog

🚀 What's Changed

📋 Release Summary

This release fixes a search issue where queries could return no results when matching zero-vector embeddings.

🐛 Bug Fixes & Stability

  • graphrag: resolve zero-vector search returning empty results 72ebbc7e

📊 Release Summary

Total commits: 1 across 1 categories

🐛 1 bug fix - Improved stability

📦 Installation

Quick Install Script (Universal)

curl -fsSL https://raw.githubusercontent.com/Muvon/octocode/main/install.sh | sh

Works on: Linux, macOS, Windows (Git Bash/WSL/MSYS2), and any Unix-like system

Manual Download

| Platform | Architecture | Download |
|----------|--------------|----------|
| Linux | x86_64 (static) | octocode-0.12.1-x86_64-unknown-linux-musl.tar.gz |
| Linux | ARM64 (static) | octocode-0.12.1-aarch64-unknown-linux-musl.tar.gz |
| Windows | x86_64 | octocode-0.12.1-x86_64-pc-windows-msvc.zip |
| Windows | ARM64 | octocode-0.12.1-aarch64-pc-windows-msvc.zip |
| macOS | x86_64 | octocode-0.12.1-x86_64-apple-darwin.tar.gz |
| macOS | ARM64 | octocode-0.12.1-aarch64-apple-darwin.tar.gz |

Using Cargo (from crates.io)

cargo install octocode

Using Cargo (from Git)

cargo install --git https://github.com/Muvon/octocode

Verify Installation

octocode --version
View release on GitHub
0.12.0 New feature
Notable features
  • Add Python project support via pyproject.toml configuration
  • Introduce hybrid vector‑keyword search with reranker for improved relevance
Full changelog

🚀 What's Changed

📋 Release Summary

This release adds Python project support and introduces hybrid vector-keyword search with reranking for more accurate code discovery. The Model Context Protocol server now offers richer configuration and graceful handling outside Git repositories. Multiple fixes improve import resolution across Go, Java, and PHP, while dependency upgrades and indexing refinements boost overall performance and stability.

✨ New Features & Enhancements

  • release: add Python project support with pyproject.toml 62282928
  • release: add server.json version update and staging 05846ca6
  • mcp: add server configuration for Model Context Protocol f0ac9e75
  • search: add hybrid vector and keyword search 32e11448
  • models: add OpenRouter embedding provider support 8f816c5d
  • commit: add -c flag to rewrite existing commit messages 6463cb22
  • search: add reranker support for improved relevance 0f8386b6

🔧 Improvements & Optimizations

  • vector: migrate from IVF_PQ to IVF_HNSW_SQ indexing 46b41014
  • graphrag: simplify tool interface and remove token limits dfc2b2e9
  • search: replace tokenization with string queries e767b195
  • search: replace inline reranker with octolib integration e8b5bc75
  • store: add table cache to reduce open overhead 26132071
  • mcp: split module into http and watcher packages 4eb9bd38
  • search: extract symbol formatting logic into helper function e78d920f
  • proxy: extract shared handlers into module fd41f15f
  • store: extract generic block operations 9cd9a401
  • languages: extract shared symbol helpers f5049453
  • graphrag: update octolib and token tracking fa630ad9

🐛 Bug Fixes & Stability

  • config: correct github owner capitalization in server.json c324c84c
  • indexer: resolve imports for Go, Java, PHP 54ed6f53
  • search: correct vector similarity threshold parameter 22f11d86
  • mcp: ensure all background tasks abort on server drop 2211f5a5
  • mcp: send indexer-disabled notification before initialize response 4c3ce3f3
  • mcp: add graceful handling when running outside git repository 9c52f627
  • storage: replace unwrap with proper error handling 0120341f

🔄 Other Changes

  • release: add homebrew tap notification job bb745289
  • add MCP server badge f76180d2
  • deps: bump octolib to 0.10.4 and update related dependencies ffa5fdca
  • deps: upgrade datafusion to 51.0.0 and lance to 2.0.0 33cc387a
  • deps: bump fastembed, image, moxcms and related crates 8cbde13f
  • use protoc action for cross-platform protobuf installation 238fc033
  • deps: upgrade octolib to 0.10.1 for openrouter embeddings 0d51e436
  • deps: bump octolib to 0.10.0 2c438f8b
  • deps: bump cargo dependencies 055c106f
  • search: add unit tests for format_symbols_for_display d4693757

📊 Release Summary

Total commits: 35 across 4 categories

✨ 7 new features - Enhanced functionality
🔧 11 improvements - Better performance & code quality
🐛 7 bug fixes - Improved stability
🔄 10 other changes - Maintenance & tooling

📦 Installation

Quick Install Script (Universal)

curl -fsSL https://raw.githubusercontent.com/Muvon/octocode/main/install.sh | sh

Works on: Linux, macOS, Windows (Git Bash/WSL/MSYS2), and any Unix-like system

Manual Download

| Platform | Architecture | Download |
|----------|--------------|----------|
| Linux | x86_64 (static) | octocode-0.12.0-x86_64-unknown-linux-musl.tar.gz |
| Linux | ARM64 (static) | octocode-0.12.0-aarch64-unknown-linux-musl.tar.gz |
| Windows | x86_64 | octocode-0.12.0-x86_64-pc-windows-msvc.zip |
| Windows | ARM64 | octocode-0.12.0-aarch64-pc-windows-msvc.zip |
| macOS | x86_64 | octocode-0.12.0-x86_64-apple-darwin.tar.gz |
| macOS | ARM64 | octocode-0.12.0-aarch64-apple-darwin.tar.gz |

Using Cargo (from crates.io)

cargo install octocode

Using Cargo (from Git)

cargo install --git https://github.com/Muvon/octocode

Verify Installation

octocode --version
View release on GitHub
0.11.0 Breaking risk
Notable features
  • Add zai and minmax providers to octolib for enhanced code analysis
Full changelog

🚀 What's Changed

📋 Release Summary

This release adds new AI providers for enhanced code analysis capabilities and delivers significant performance improvements through optimized graph traversal and query processing. Multiple bug fixes enhance system stability, improve text chunking accuracy, and ensure reliable metadata handling across the codebase.

✨ New Features & Enhancements

  • octolib: add zai and minmax providers fbe220a9

🔧 Improvements & Optimizations

  • graphrag: simplify nested if-else conditionals d339b663
  • commands/commit: enforce plain text format in AI prompts af0e3ffd
  • review: process JSON values directly 62992723
  • llm: unify config and integrate octolib LlmClient 06aef91d
  • indexer: simplify code embedding and unify logic ba35f2d7
  • store: simplify CacheStats struct initialization in test f35032cd
  • graphrag: add adjacency cache for graph traversal optimization 06480d97
  • graphrag: improve queries with typed relations and pagination 52f2dab7
  • embedding: replace providers with octolib integration 3db03b98

🐛 Bug Fixes & Stability

  • config: handle missing embedding provider in test 77704c9a
  • embedding: handle parse_provider_model errors properly 8ef62370
  • indexer: guarantee forward progress in text chunking loop 72c70303
  • indexer: correct end_idx calculation in text chunking 9f75b3be
  • mcp: handle JSON-RPC notifications without response 8251b243
  • zai: resolve provider issue a09718f6
  • utils: handle single-line commit messages safely 979188b0
  • indexer: flush store before saving metadata 2a135443
  • graphrag: align batch schema field names for source_id handling e653ee5b
  • docker: update Rust base image to 1.91-slim 6d550f0c
  • octolib: disable default features and enable embed by default 5d176da7
  • ci: update cc crate and disable doctests on Windows d46af3b8

🔄 Other Changes

  • upgrade Rust toolchain to 1.92.0 0974150e
  • deps: bump octolib to 0.8.1 6b0d7648
  • deps: upgrade octolib to 0.7.0 63ae7cc0
  • deps: update lance with geospatial support c583b1a5
  • memory: extract memory to separate binary 113f9753
  • deps: bump octolib to v0.5.1 a8fd0156
  • deps: update octolib and zune-core eee88b0c
  • release: update macOS runner to 14 5c6d7a22
  • deps: upgrade reqwest and tree-sitter crates 6e58781c
  • deps: bump dependency versions in Cargo.lock afeaba6b
  • cargo: bump deps and adapt to upstream API 9295417a
  • commands: clarify breaking change policy in prompt 4626e1d8
  • deps: update syn, http, and other dependencies 4b062e75
  • deps: lock octolib to crates.io release version 78a9e7e6
  • deps: update tracing-subscriber and core dependencies eb6db5f5

📊 Release Summary

Total commits: 37 across 4 categories

✨ 1 new feature - Enhanced functionality
🔧 9 improvements - Better performance & code quality
🐛 12 bug fixes - Improved stability
🔄 15 other changes - Maintenance & tooling

📦 Installation

Quick Install Script (Universal)

curl -fsSL https://raw.githubusercontent.com/Muvon/octocode/main/install.sh | sh

Works on: Linux, macOS, Windows (Git Bash/WSL/MSYS2), and any Unix-like system

Manual Download

| Platform | Architecture | Download |
|----------|--------------|----------|
| Linux | x86_64 (static) | octocode-0.11.0-x86_64-unknown-linux-musl.tar.gz |
| Linux | ARM64 (static) | octocode-0.11.0-aarch64-unknown-linux-musl.tar.gz |
| Windows | x86_64 | octocode-0.11.0-x86_64-pc-windows-msvc.zip |
| Windows | ARM64 | octocode-0.11.0-aarch64-pc-windows-msvc.zip |
| macOS | x86_64 | octocode-0.11.0-x86_64-apple-darwin.tar.gz |
| macOS | ARM64 | octocode-0.11.0-aarch64-apple-darwin.tar.gz |

Using Cargo (from crates.io)

cargo install octocode

Using Cargo (from Git)

cargo install --git https://github.com/Muvon/octocode

Verify Installation

octocode --version
View release on GitHub

Beta — feedback welcome: [email protected]