cocoindex-code 0.1.9__tar.gz → 0.1.11__tar.gz

{cocoindex_code-0.1.9 → cocoindex_code-0.1.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cocoindex-code
-Version: 0.1.9
+Version: 0.1.11
 Summary: MCP server for indexing and querying codebases using CocoIndex
 Project-URL: Homepage, https://github.com/cocoindex-io/cocoindex-code
 Project-URL: Repository, https://github.com/cocoindex-io/cocoindex-code
@@ -17,7 +17,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.11
-Requires-Dist: cocoindex[litellm]==1.0.0a24
+Requires-Dist: cocoindex[litellm]==1.0.0a26
 Requires-Dist: einops>=0.8.2
 Requires-Dist: mcp>=1.0.0
 Requires-Dist: numpy>=1.24.0
@@ -79,10 +79,15 @@ A super light-weight, effective embedded MCP **(AST-based)** that understand and
 
 ## Get Started - zero config, let's go!!
 
-Requires Python 3 (`pip3` comes pre-installed with Python).
+Using [pipx](https://pipx.pypa.io/stable/installation/):
+```bash
+pipx install cocoindex-code       # first install
+pipx upgrade cocoindex-code       # upgrade
+```
 
+Using [uv](https://docs.astral.sh/uv/getting-started/installation/):
 ```bash
-pip3 install -U cocoindex-code
+uv tool install --upgrade cocoindex-code --prerelease explicit --with "cocoindex>=1.0.0a24"
 ```
 
 ### Claude
@@ -118,7 +123,17 @@ Or use opencode.json:
 }
 ```
 
-Optionally, you can run `cocoindex-code index` to create or update the index. Without running it, the MCP server will automatically build and keep the index up-to-date in the background.
+### Build the Index
+
+For large codebases, we recommend running the indexer once before using the MCP so you can see the progress:
+
+```bash
+cocoindex-code index
+```
+
+This lets you monitor the indexing process and ensure everything is ready. After the initial build, the MCP server will automatically keep the index up-to-date in the background as files change.
+
+For small projects you can skip this step — the MCP server will build the index automatically on first use.
 
 ## When Is the MCP Triggered?
 
@@ -293,7 +308,7 @@ claude mcp add cocoindex-code \
   -- cocoindex-code
 ```
 
-> **Note:** Switching models requires re-indexing your codebase (the vector dimensions differ).
+**Note:** Switching models requires re-indexing your codebase (the vector dimensions differ).
 
 ## MCP Tools
 
@@ -377,10 +392,17 @@ Some Python installations (e.g. the one pre-installed on macOS) ship with a SQLi
 brew install python3
 ```
 
-Then re-install cocoindex-code with the Homebrew Python:
+Then re-install cocoindex-code (see [Get Started](#get-started---zero-config-lets-go) for install options):
+
+Using pipx:
+```bash
+pipx install cocoindex-code       # first install
+pipx upgrade cocoindex-code       # upgrade
+```
 
+Using uv (install or upgrade):
 ```bash
-pip3 install -U cocoindex-code
+uv tool install --upgrade cocoindex-code --prerelease explicit --with "cocoindex>=1.0.0a24"
 ```
 
 ## Large codebase / Enterprise

{cocoindex_code-0.1.9 → cocoindex_code-0.1.11}/README.md

@@ -44,10 +44,15 @@ A super light-weight, effective embedded MCP **(AST-based)** that understand and
 
 ## Get Started - zero config, let's go!!
 
-Requires Python 3 (`pip3` comes pre-installed with Python).
+Using [pipx](https://pipx.pypa.io/stable/installation/):
+```bash
+pipx install cocoindex-code       # first install
+pipx upgrade cocoindex-code       # upgrade
+```
 
+Using [uv](https://docs.astral.sh/uv/getting-started/installation/):
 ```bash
-pip3 install -U cocoindex-code
+uv tool install --upgrade cocoindex-code --prerelease explicit --with "cocoindex>=1.0.0a24"
 ```
 
 ### Claude
@@ -83,7 +88,17 @@ Or use opencode.json:
 }
 ```
 
-Optionally, you can run `cocoindex-code index` to create or update the index. Without running it, the MCP server will automatically build and keep the index up-to-date in the background.
+### Build the Index
+
+For large codebases, we recommend running the indexer once before using the MCP so you can see the progress:
+
+```bash
+cocoindex-code index
+```
+
+This lets you monitor the indexing process and ensure everything is ready. After the initial build, the MCP server will automatically keep the index up-to-date in the background as files change.
+
+For small projects you can skip this step — the MCP server will build the index automatically on first use.
 
 ## When Is the MCP Triggered?
 
@@ -258,7 +273,7 @@ claude mcp add cocoindex-code \
   -- cocoindex-code
 ```
 
-> **Note:** Switching models requires re-indexing your codebase (the vector dimensions differ).
+**Note:** Switching models requires re-indexing your codebase (the vector dimensions differ).
 
 ## MCP Tools
 
@@ -342,10 +357,17 @@ Some Python installations (e.g. the one pre-installed on macOS) ship with a SQLi
 brew install python3
 ```
 
-Then re-install cocoindex-code with the Homebrew Python:
+Then re-install cocoindex-code (see [Get Started](#get-started---zero-config-lets-go) for install options):
+
+Using pipx:
+```bash
+pipx install cocoindex-code       # first install
+pipx upgrade cocoindex-code       # upgrade
+```
 
+Using uv (install or upgrade):
 ```bash
-pip3 install -U cocoindex-code
+uv tool install --upgrade cocoindex-code --prerelease explicit --with "cocoindex>=1.0.0a24"
 ```
 
 ## Large codebase / Enterprise

{cocoindex_code-0.1.9 → cocoindex_code-0.1.11}/pyproject.toml

@@ -23,7 +23,7 @@ classifiers = [
 
 dependencies = [
     "mcp>=1.0.0",
-    "cocoindex[litellm]==1.0.0a24",
+    "cocoindex[litellm]==1.0.0a26",
     "sentence-transformers>=2.2.0",
     "sqlite-vec>=0.1.0",
     "pydantic>=2.0.0",

cocoindex_code-0.1.11/src/cocoindex_code/__init__.py

@@ -0,0 +1,11 @@
+"""CocoIndex Code - MCP server for indexing and querying codebases."""
+
+import logging
+
+logging.basicConfig(level=logging.WARNING)
+
+from .config import Config  # noqa: E402
+from .server import main, mcp  # noqa: E402
+
+__version__ = "0.1.0"
+__all__ = ["Config", "main", "mcp"]

{cocoindex_code-0.1.9 → cocoindex_code-0.1.11}/src/cocoindex_code/server.py

@@ -30,6 +30,9 @@ mcp = FastMCP(
 # Lock to prevent concurrent index updates
 _index_lock = asyncio.Lock()
 
+# Event set once the initial background index is ready
+_initial_index_done = asyncio.Event()
+
 
 async def _refresh_index() -> None:
     """Refresh the index. Uses lock to prevent concurrent updates."""
@@ -123,6 +126,16 @@ async def search(
     ),
 ) -> SearchResultModel:
     """Query the codebase index."""
+    if not _initial_index_done.is_set():
+        return SearchResultModel(
+            success=False,
+            message=(
+                "The index is still being built — this may take a while"
+                " for a large codebase or after significant changes."
+                " Please try again shortly."
+            ),
+        )
+
     try:
         # Refresh index if requested
         if refresh_index:
@@ -167,8 +180,15 @@ async def search(
 
 async def _async_serve() -> None:
     """Async entry point for the MCP server."""
+
     # Refresh index in background so startup isn't blocked
-    asyncio.create_task(_refresh_index())
+    async def _initial_index() -> None:
+        try:
+            await _refresh_index()
+        finally:
+            _initial_index_done.set()
+
+    asyncio.create_task(_initial_index())
     await mcp.run_stdio_async()
 
 

cocoindex_code-0.1.9/src/cocoindex_code/__init__.py

@@ -1,7 +0,0 @@
-"""CocoIndex Code - MCP server for indexing and querying codebases."""
-
-from .config import Config
-from .server import main, mcp
-
-__version__ = "0.1.0"
-__all__ = ["Config", "main", "mcp"]