Skip to content

muvon/octocode

MCP Developer Tools

Octocode gives AI assistants a structured knowledge graph of your codebase for semantic search and dependency navigation

Rust Latest 0.15.0 · 12d ago Security brief →

Features

  • Semantic search that finds code by meaning, not just keywords
  • Knowledge graph mapping imports, calls, and other dependencies between files
  • Code signature view showing function structure without reading full files
  • Persistent memory for AI agents to remember context across sessions

Recent releases

View all 8 releases →
No immediate action
0.15.0 Mixed

Hybrid search + GraphRAG improvements

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
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
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
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

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

About

Stars
391
Forks
40
Languages
Rust HTML CSS

Install & Platforms

Install via
shell-script brew cargo
Platforms
linux macos windows

Beta — feedback welcome: [email protected]