octocode AGENTS.md

Octocode — AI-Powered Code Intelligence

Rust CLI tool (v0.14.x) that indexes codebases into LanceDB vector stores, builds knowledge graphs via GraphRAG, and exposes everything through an MCP server for AI assistant integration. Core stack: Rust + tokio + LanceDB + tree-sitter + octolib (embedding/LLM providers). Embedding providers and LLM are delegated entirely to octolib.

Project Structure

src/
  main.rs                    — CLI entry point, command dispatch
  config.rs                  — All config structs; NO runtime defaults (panic on missing)
  storage.rs                 — Project DB path resolution (~/.local/share/octocode/<hash>/)
  store/                     — LanceDB operations
    mod.rs                   — Store struct, block types (CodeBlock, TextBlock, DocumentBlock, CommitBlock)
    vector_optimizer.rs      — Auto-tuned IVF_RQ / IVF_HNSW_SQ index selection
    batch_converter.rs       — Arrow RecordBatch construction
    table_ops.rs             — content_exists(), low-level table ops
    graphrag.rs              — GraphRAG node storage
    metadata.rs              — Table metadata helpers
  embedding/mod.rs           — Thin wrapper over octolib; generate_embeddings*, hash utilities
  llm/mod.rs                 — Thin wrapper over octolib LLM; LlmClient::from_config()
  indexer/
    mod.rs                   — NoindexWalker, file pipeline orchestration
    languages/               — One file per language, all implement Language trait
    graphrag/                — GraphRAG builder, AI relationship discovery
    batch_processor.rs       — Batch embedding + flush logic
    differential_processor.rs — Incremental file change processing
    contextual.rs            — LLM-based contextual chunk enrichment
    commits/                 — Git commit history indexing
  mcp/
    server.rs                — McpServer (rmcp-based, stdin + HTTP modes)
    semantic_code.rs         — SemanticCodeProvider tool impl
    graphrag.rs              — GraphRagProvider tool impl
    lsp/                     — LSP integration tools
    proxy.rs                 — Multi-repo MCP proxy
  commands/                  — One file per CLI subcommand
config-templates/default.toml — Single source of truth for ALL config defaults