From 68aa8a373ad4427d15f9ce33fd3da726f6a744a9 Mon Sep 17 00:00:00 2001 From: nicholaspsmith Date: Tue, 27 Jan 2026 11:07:45 -0500 Subject: [PATCH] docs: add warning about 1.18.x performance issues - Add warning banner recommending 1.17.1 for Ollama users - Update installation instructions to use stable version Co-Authored-By: Claude --- README.md | 20 +++++++++++++++++--- 1 file changed, 17 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 39ffdee..ca6dd38 100644 --- a/README.md +++ b/README.md @@ -9,6 +9,18 @@ Node.js version

+> [!WARNING] +> **Versions 1.18.x have known performance issues with Ollama embedding.** +> +> If you experience hangs during indexing, use the stable version: +> ```bash +> npm install lance-context@1.17.1 +> ``` +> Or with Claude Code: +> ```bash +> claude mcp add --scope user --transport stdio lance-context -- npx -y lance-context@1.17.1 +> ``` + # lance-context An MCP plugin that adds semantic code search to Claude Code and other AI coding agents, giving them deep context from your entire codebase. @@ -26,13 +38,15 @@ An MCP plugin that adds semantic code search to Claude Code and other AI coding ### Quick Install (Recommended) -Add lance-context to Claude Code with automatic updates: +Add lance-context to Claude Code: ```bash -claude mcp add --scope user --transport stdio lance-context -- npx -y lance-context@latest +claude mcp add --scope user --transport stdio lance-context -- npx -y lance-context@1.17.1 ``` -This ensures you always run the latest version. Restart Claude Code to start using semantic search. +Restart Claude Code to start using semantic search. + +> **Note:** To try the latest (alpha) version: `npx -y lance-context@alpha` ### Global Install (Alternative)