index1

AI memory system for coding agents with BM25 + vector hybrid search. Provides 6 MCP tools for intelligent code/doc search and cognitive fact recording.

What it does

• - Dual memory: corpus (code index) + cognition (episodic facts)
• Hybrid search: BM25 full-text + vector semantic search with RRF fusion
• Structure-aware chunking: Markdown, Python, Rust, JavaScript, plain text
• MCP Server: 6 tools (recall, learn, read, status, reindex, config)
• CJK optimized: Chinese/Japanese/Korean query detection with dynamic weight tuning
• Built-in ONNX embedding: Vector search works out of the box, no Ollama required
• Graceful degradation: Works without any embedding service (BM25-only mode)

Install

CODEBLOCK0

One-click plugin setup:

CODEBLOCK1

Verify:

CODEBLOCK2

Setup MCP

Create .mcp.json in your project root:

CODEBLOCK3

If index1 is not in PATH, use the full path from which index1.

Add Search Rules

Add to your project's .claude/CLAUDE.md:

CODEBLOCK4

Impact:

CODEBLOCK5

Index Your Project

CODEBLOCK6

Optional: Multilingual Enhancement

index1 v2 has built-in ONNX embedding (bge-small-en-v1.5). For better multilingual support:

CODEBLOCK7

Without Ollama, ONNX embedding provides vector search out of the box.

Web UI

CODEBLOCK8

MCP Tools Reference

Tool	Description
INLINECODE10	Unified search — code + cognitive facts, BM25 + vector hybrid
INLINECODE11

Record insights, decisions, lessons learned (auto-classify + dedup) | | read | Read file content + index metadata | | status | Index and cognition statistics | | reindex | Rebuild index for a path or collection | | config | View or modify configuration |

Troubleshooting

Issue	Fix
Tools not showing	Check .mcp.json format and index1 path
AI doesn't use recall

Add search rules to CLAUDE.md | | command not found | Use full path from which index1 | | Chinese search returns 0 | Install Ollama + bge-m3 model | | No vector search | Built-in ONNX should work; run index1 doctor |