muvon/octocode
MCP Developer ToolsOctocode gives AI assistants a structured knowledge graph of your codebase for semantic search and dependency navigation
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 →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
- search: unified architecture replaces prior separated search implementation
- 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
- search: add detail levels for commit results (commit search now requires a `detail` parameter)
- 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
- 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.