chore: guide users always upgrade to latest

Author: georgeh0

README.md

@@ -19,7 +19,7 @@ No installation needed — `uvx` runs it directly.
 Uses a local SentenceTransformers model (`sentence-transformers/all-MiniLM-L6-v2`). No API key required:
 
 ```bash
-claude mcp add cocoindex-code -- uvx cocoindex-code
+claude mcp add cocoindex-code -- uvx cocoindex-code@latest
 ```
 
 ### With a Cloud or Custom Embedding Model
@@ -32,7 +32,7 @@ Set `COCOINDEX_CODE_EMBEDDING_MODEL` to any [LiteLLM-supported model](https://do
 ```bash
 claude mcp add cocoindex-code \
   -e COCOINDEX_CODE_EMBEDDING_MODEL=ollama/nomic-embed-text \
-  -- uvx cocoindex-code
+  -- uvx cocoindex-code@latest
 ```
 
 Set `OLLAMA_API_BASE` if your Ollama server is not at `http://localhost:11434`.
@@ -46,7 +46,7 @@ Set `OLLAMA_API_BASE` if your Ollama server is not at `http://localhost:11434`.
 claude mcp add cocoindex-code \
   -e COCOINDEX_CODE_EMBEDDING_MODEL=text-embedding-3-small \
   -e OPENAI_API_KEY=your-api-key \
-  -- uvx cocoindex-code
+  -- uvx cocoindex-code@latest
 ```
 
 </details>
@@ -60,7 +60,7 @@ claude mcp add cocoindex-code \
   -e AZURE_API_KEY=your-api-key \
   -e AZURE_API_BASE=https://your-resource.openai.azure.com \
   -e AZURE_API_VERSION=2024-06-01 \
-  -- uvx cocoindex-code
+  -- uvx cocoindex-code@latest
 ```
 
 </details>
@@ -72,7 +72,7 @@ claude mcp add cocoindex-code \
 claude mcp add cocoindex-code \
   -e COCOINDEX_CODE_EMBEDDING_MODEL=gemini/text-embedding-004 \
   -e GEMINI_API_KEY=your-api-key \
-  -- uvx cocoindex-code
+  -- uvx cocoindex-code@latest
 ```
 
 </details>
@@ -84,7 +84,7 @@ claude mcp add cocoindex-code \
 claude mcp add cocoindex-code \
   -e COCOINDEX_CODE_EMBEDDING_MODEL=mistral/mistral-embed \
   -e MISTRAL_API_KEY=your-api-key \
-  -- uvx cocoindex-code
+  -- uvx cocoindex-code@latest
 ```
 
 </details>
@@ -96,7 +96,7 @@ claude mcp add cocoindex-code \
 claude mcp add cocoindex-code \
   -e COCOINDEX_CODE_EMBEDDING_MODEL=voyage/voyage-code-3 \
   -e VOYAGE_API_KEY=your-api-key \
-  -- uvx cocoindex-code
+  -- uvx cocoindex-code@latest
 ```
 
 </details>
@@ -108,7 +108,7 @@ claude mcp add cocoindex-code \
 claude mcp add cocoindex-code \
   -e COCOINDEX_CODE_EMBEDDING_MODEL=cohere/embed-english-v3.0 \
   -e COHERE_API_KEY=your-api-key \
-  -- uvx cocoindex-code
+  -- uvx cocoindex-code@latest
 ```
 
 </details>
@@ -122,7 +122,7 @@ claude mcp add cocoindex-code \
   -e AWS_ACCESS_KEY_ID=your-access-key \
   -e AWS_SECRET_ACCESS_KEY=your-secret-key \
   -e AWS_REGION_NAME=us-east-1 \
-  -- uvx cocoindex-code
+  -- uvx cocoindex-code@latest
 ```
 
 </details>
@@ -134,7 +134,7 @@ claude mcp add cocoindex-code \
 claude mcp add cocoindex-code \
   -e COCOINDEX_CODE_EMBEDDING_MODEL=nebius/BAAI/bge-en-icl \
   -e NEBIUS_API_KEY=your-api-key \
-  -- uvx cocoindex-code
+  -- uvx cocoindex-code@latest
 ```
 
 </details>
@@ -182,12 +182,12 @@ If `COCOINDEX_CODE_ROOT_PATH` is not set, the codebase root is discovered by:
 
 ## MCP Tools
 
-### `query`
+### `search`
 
 Search the codebase using semantic similarity.
 
 ```
-query(
+search(
     query: str,               # Natural language query or code snippet
     limit: int = 10,          # Maximum results (1-100)
     offset: int = 0,          # Pagination offset

src/cocoindex_code/server.py

@@ -16,13 +16,13 @@
 This allows you to quickly and cheaply search for code related to a concept or functionality
 across the entire codebase.
 
-Use the `query` tool when you need to:
+Use the `search` tool when you need to:
 - Find code related to a concept or functionality
 - Search for implementations of specific features
 - Discover how something is done in the codebase
 - Find similar code patterns
 
-The `query` tool has a `refresh_index` parameter (default: True) that refreshes
+The `search` tool has a `refresh_index` parameter (default: True) that refreshes
 the index before searching. Set it to False for consecutive queries to avoid
 redundant refreshes.
 
@@ -55,8 +55,8 @@ class CodeChunkResult(BaseModel):
     score: float = Field(description="Similarity score (0-1, higher is better)")
 
 
-class QueryResultModel(BaseModel):
-    """Result from query tool."""
+class SearchResultModel(BaseModel):
+    """Result from search tool."""
 
     success: bool
     results: list[CodeChunkResult] = Field(default_factory=list)
@@ -69,14 +69,14 @@ class QueryResultModel(BaseModel):
 
 
 @mcp.tool(
-    name="query",
+    name="search",
     description=(
         "Search the codebase using semantic similarity. "
         "Returns relevant code chunks with file locations and similarity scores. "
         "Use natural language queries or code snippets to find related code."
     ),
 )
-async def query(
+async def search(
     query: str = Field(description="Natural language query or code snippet to search for"),
     limit: int = Field(
         default=10,
@@ -96,7 +96,7 @@ async def query(
             "Set to False for consecutive queries to skip redundant refreshes."
         ),
     ),
-) -> QueryResultModel:
+) -> SearchResultModel:
     """Query the codebase index."""
     try:
         # Refresh index if requested
@@ -105,7 +105,7 @@ async def query(
 
         results = await query_codebase(query=query, limit=limit, offset=offset)
 
-        return QueryResultModel(
+        return SearchResultModel(
             success=True,
             results=[
                 CodeChunkResult(
@@ -123,12 +123,12 @@ async def query(
         )
     except RuntimeError as e:
         # Index doesn't exist
-        return QueryResultModel(
+        return SearchResultModel(
             success=False,
             message=str(e),
         )
     except Exception as e:
-        return QueryResultModel(
+        return SearchResultModel(
             success=False,
             message=f"Query failed: {e!s}",
         )