chunkhound 2.4.2__tar.gz → 2.4.4__tar.gz

{chunkhound-2.4.2 → chunkhound-2.4.4}/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.4.4] - 2025-01-09
+
+### Fixed
+- Ubuntu TaskGroup crash fixed by removing problematic directory change in MCP launcher
+
+## [2.4.3] - 2025-01-09
+
+### Fixed
+- MCP server now works correctly when launched from any directory, not just the project root
+- Fixed path resolution inconsistencies that caused TaskGroup errors on Ubuntu deployments
+
 ## [2.4.2] - 2025-01-09
 
 ### Added
@@ -260,7 +271,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 For more information, visit: https://github.com/chunkhound/chunkhound
 
-[Unreleased]: https://github.com/chunkhound/chunkhound/compare/v2.4.2...HEAD
+[Unreleased]: https://github.com/chunkhound/chunkhound/compare/v2.4.4...HEAD
+[2.4.4]: https://github.com/chunkhound/chunkhound/compare/v2.4.3...v2.4.4
+[2.4.3]: https://github.com/chunkhound/chunkhound/compare/v2.4.2...v2.4.3
 [2.4.2]: https://github.com/chunkhound/chunkhound/compare/v2.4.1...v2.4.2
 [2.4.1]: https://github.com/chunkhound/chunkhound/compare/v2.4.0...v2.4.1
 [2.4.0]: https://github.com/chunkhound/chunkhound/compare/v2.3.1...v2.4.0

{chunkhound-2.4.2 → chunkhound-2.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chunkhound
-Version: 2.4.2
+Version: 2.4.4
 Summary: Local-first semantic code search with vector and regex capabilities for AI assistants via MCP
 Project-URL: Homepage, https://github.com/chunkhound/chunkhound
 Project-URL: Repository, https://github.com/chunkhound/chunkhound
@@ -105,6 +105,12 @@ uv run chunkhound index
 # 2. Start MCP server for AI assistants (auto-watches for changes)
 uv run chunkhound mcp
 
+# Work with any project directory - complete project scope control
+uv run chunkhound mcp /path/to/your/project
+# This sets database to /path/to/your/project/.chunkhound/db
+# Searches for config at /path/to/your/project/.chunkhound.json
+# Watches /path/to/your/project for changes
+
 # Optional: Set OpenAI API key for semantic search
 export CHUNKHOUND_EMBEDDING__API_KEY="sk-your-key-here"
 
@@ -114,17 +120,28 @@ uv run chunkhound index --config /path/to/different-config.json
 
 ### Automatic Configuration Detection
 
-When you run `chunkhound index` in any directory, ChunkHound automatically:
-1. Looks for `.chunkhound.json` in that directory
-2. Loads it if found (no `--config` flag needed)
-3. Uses those settings for indexing
+ChunkHound automatically detects and uses project configurations:
 
-Example:
+**For `index` command:**
 ```bash
 cd /my/project              # Has .chunkhound.json
 uv run chunkhound index     # Automatically uses /my/project/.chunkhound.json
 ```
 
+**For `mcp` command with positional path:**
+```bash
+uv run chunkhound mcp /my/project
+# Automatically uses /my/project/.chunkhound.json
+# Sets database to /my/project/.chunkhound/db
+# Watches /my/project for changes
+```
+
+**For `mcp` command without path:**
+```bash
+cd /my/project              # Has .chunkhound.json
+uv run chunkhound mcp       # Automatically uses /my/project/.chunkhound.json
+```
+
 ## Features
 
 **Always Available:**
@@ -157,6 +174,18 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
   }
 }
 ```
+
+**For specific project directories:**
+```json
+{
+  "mcpServers": {
+    "chunkhound": {
+      "command": "uv",
+      "args": ["run", "chunkhound", "mcp", "/path/to/your/project"]
+    }
+  }
+}
+```
 </details>
 
 <details>
@@ -173,6 +202,18 @@ Add to `~/.claude.json`:
   }
 }
 ```
+
+**For specific project directories:**
+```json
+{
+  "mcpServers": {
+    "chunkhound": {
+      "command": "uv",
+      "args": ["run", "chunkhound", "mcp", "/path/to/your/project"]
+    }
+  }
+}
+```
 </details>
 
 <details>
@@ -189,6 +230,18 @@ Add to `.vscode/mcp.json` in your project:
   }
 }
 ```
+
+**For specific project directories:**
+```json
+{
+  "servers": {
+    "chunkhound": {
+      "command": "uv",
+      "args": ["run", "chunkhound", "mcp", "/path/to/your/project"]
+    }
+  }
+}
+```
 </details>
 
 <details>
@@ -205,6 +258,18 @@ Add to `.cursor/mcp.json` in your project:
   }
 }
 ```
+
+**For specific project directories:**
+```json
+{
+  "mcpServers": {
+    "chunkhound": {
+      "command": "uv",
+      "args": ["run", "chunkhound", "mcp", "/path/to/your/project"]
+    }
+  }
+}
+```
 </details>
 
 <details>
@@ -221,6 +286,18 @@ Add to `~/.codeium/windsurf/mcp_config.json`:
   }
 }
 ```
+
+**For specific project directories:**
+```json
+{
+  "mcpServers": {
+    "chunkhound": {
+      "command": "uv",
+      "args": ["run", "chunkhound", "mcp", "/path/to/your/project"]
+    }
+  }
+}
+```
 </details>
 
 <details>
@@ -240,6 +317,21 @@ Add to settings.json (Preferences > Open Settings):
   }
 }
 ```
+
+**For specific project directories:**
+```json
+{
+  "context_servers": {
+    "chunkhound": {
+      "source": "custom",
+      "command": {
+        "path": "uv",
+        "args": ["run", "chunkhound", "mcp", "/path/to/your/project"]
+      }
+    }
+  }
+}
+```
 </details>
 
 <details>
@@ -250,6 +342,12 @@ Go to Settings > Tools > AI Assistant > Model Context Protocol (MCP) and add:
 - **Command**: uv
 - **Arguments**: run chunkhound mcp
 - **Working Directory**: (leave empty or set to project root)
+
+**For specific project directories:**
+- **Name**: chunkhound
+- **Command**: uv
+- **Arguments**: run chunkhound mcp /path/to/your/project
+- **Working Directory**: (leave empty)
 </details>
 
 </details>
@@ -285,10 +383,24 @@ ChunkHound loads configuration in this order (highest priority first):
 
 ### Database Location
 
-By default, ChunkHound creates `.chunkhound.db` in your current directory. Customize with:
+ChunkHound automatically determines the database location based on project scope:
 
-- **Config file**: Add to `.chunkhound.json`: `{"database": {"path": "/path/to/.chunkhound.db"}}`
+**With positional path argument:**
+```bash
+uv run chunkhound mcp /my/project
+# Database automatically created at: /my/project/.chunkhound/db
+```
+
+**Without positional path (current directory):**
+```bash
+cd /my/project
+uv run chunkhound mcp
+# Database created at: /my/project/.chunkhound/db
+```
+
+**Manual overrides** (in priority order):
 - **Command line**: `--database-path /path/to/my-chunks`
+- **Config file**: Add to `.chunkhound.json`: `{"database": {"path": "/path/to/.chunkhound.db"}}`
 - **Environment variable**: `CHUNKHOUND_DATABASE__PATH="/path/to/.chunkhound.db"`
 
 ### Configuration File Format
@@ -571,6 +683,11 @@ ChunkHound indexes your codebase in three layers:
 2. **Background scan** - MCP server checks for changes every 5 minutes  
 3. **Real-time updates** - File system events trigger immediate updates
 
+**Project Scope Control:**
+- `chunkhound mcp` - Uses current directory as project root
+- `chunkhound mcp /path/to/project` - Uses specified path as project root
+- Database, config, and watch paths all scoped to project root
+
 **Processing pipeline:**
 Scan → Parse → Index → Embed → Search
 

{chunkhound-2.4.2 → chunkhound-2.4.4}/README.md

@@ -45,6 +45,12 @@ uv run chunkhound index
 # 2. Start MCP server for AI assistants (auto-watches for changes)
 uv run chunkhound mcp
 
+# Work with any project directory - complete project scope control
+uv run chunkhound mcp /path/to/your/project
+# This sets database to /path/to/your/project/.chunkhound/db
+# Searches for config at /path/to/your/project/.chunkhound.json
+# Watches /path/to/your/project for changes
+
 # Optional: Set OpenAI API key for semantic search
 export CHUNKHOUND_EMBEDDING__API_KEY="sk-your-key-here"
 
@@ -54,17 +60,28 @@ uv run chunkhound index --config /path/to/different-config.json
 
 ### Automatic Configuration Detection
 
-When you run `chunkhound index` in any directory, ChunkHound automatically:
-1. Looks for `.chunkhound.json` in that directory
-2. Loads it if found (no `--config` flag needed)
-3. Uses those settings for indexing
+ChunkHound automatically detects and uses project configurations:
 
-Example:
+**For `index` command:**
 ```bash
 cd /my/project              # Has .chunkhound.json
 uv run chunkhound index     # Automatically uses /my/project/.chunkhound.json
 ```
 
+**For `mcp` command with positional path:**
+```bash
+uv run chunkhound mcp /my/project
+# Automatically uses /my/project/.chunkhound.json
+# Sets database to /my/project/.chunkhound/db
+# Watches /my/project for changes
+```
+
+**For `mcp` command without path:**
+```bash
+cd /my/project              # Has .chunkhound.json
+uv run chunkhound mcp       # Automatically uses /my/project/.chunkhound.json
+```
+
 ## Features
 
 **Always Available:**
@@ -97,6 +114,18 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
   }
 }
 ```
+
+**For specific project directories:**
+```json
+{
+  "mcpServers": {
+    "chunkhound": {
+      "command": "uv",
+      "args": ["run", "chunkhound", "mcp", "/path/to/your/project"]
+    }
+  }
+}
+```
 </details>
 
 <details>
@@ -113,6 +142,18 @@ Add to `~/.claude.json`:
   }
 }
 ```
+
+**For specific project directories:**
+```json
+{
+  "mcpServers": {
+    "chunkhound": {
+      "command": "uv",
+      "args": ["run", "chunkhound", "mcp", "/path/to/your/project"]
+    }
+  }
+}
+```
 </details>
 
 <details>
@@ -129,6 +170,18 @@ Add to `.vscode/mcp.json` in your project:
   }
 }
 ```
+
+**For specific project directories:**
+```json
+{
+  "servers": {
+    "chunkhound": {
+      "command": "uv",
+      "args": ["run", "chunkhound", "mcp", "/path/to/your/project"]
+    }
+  }
+}
+```
 </details>
 
 <details>
@@ -145,6 +198,18 @@ Add to `.cursor/mcp.json` in your project:
   }
 }
 ```
+
+**For specific project directories:**
+```json
+{
+  "mcpServers": {
+    "chunkhound": {
+      "command": "uv",
+      "args": ["run", "chunkhound", "mcp", "/path/to/your/project"]
+    }
+  }
+}
+```
 </details>
 
 <details>
@@ -161,6 +226,18 @@ Add to `~/.codeium/windsurf/mcp_config.json`:
   }
 }
 ```
+
+**For specific project directories:**
+```json
+{
+  "mcpServers": {
+    "chunkhound": {
+      "command": "uv",
+      "args": ["run", "chunkhound", "mcp", "/path/to/your/project"]
+    }
+  }
+}
+```
 </details>
 
 <details>
@@ -180,6 +257,21 @@ Add to settings.json (Preferences > Open Settings):
   }
 }
 ```
+
+**For specific project directories:**
+```json
+{
+  "context_servers": {
+    "chunkhound": {
+      "source": "custom",
+      "command": {
+        "path": "uv",
+        "args": ["run", "chunkhound", "mcp", "/path/to/your/project"]
+      }
+    }
+  }
+}
+```
 </details>
 
 <details>
@@ -190,6 +282,12 @@ Go to Settings > Tools > AI Assistant > Model Context Protocol (MCP) and add:
 - **Command**: uv
 - **Arguments**: run chunkhound mcp
 - **Working Directory**: (leave empty or set to project root)
+
+**For specific project directories:**
+- **Name**: chunkhound
+- **Command**: uv
+- **Arguments**: run chunkhound mcp /path/to/your/project
+- **Working Directory**: (leave empty)
 </details>
 
 </details>
@@ -225,10 +323,24 @@ ChunkHound loads configuration in this order (highest priority first):
 
 ### Database Location
 
-By default, ChunkHound creates `.chunkhound.db` in your current directory. Customize with:
+ChunkHound automatically determines the database location based on project scope:
 
-- **Config file**: Add to `.chunkhound.json`: `{"database": {"path": "/path/to/.chunkhound.db"}}`
+**With positional path argument:**
+```bash
+uv run chunkhound mcp /my/project
+# Database automatically created at: /my/project/.chunkhound/db
+```
+
+**Without positional path (current directory):**
+```bash
+cd /my/project
+uv run chunkhound mcp
+# Database created at: /my/project/.chunkhound/db
+```
+
+**Manual overrides** (in priority order):
 - **Command line**: `--database-path /path/to/my-chunks`
+- **Config file**: Add to `.chunkhound.json`: `{"database": {"path": "/path/to/.chunkhound.db"}}`
 - **Environment variable**: `CHUNKHOUND_DATABASE__PATH="/path/to/.chunkhound.db"`
 
 ### Configuration File Format
@@ -511,6 +623,11 @@ ChunkHound indexes your codebase in three layers:
 2. **Background scan** - MCP server checks for changes every 5 minutes  
 3. **Real-time updates** - File system events trigger immediate updates
 
+**Project Scope Control:**
+- `chunkhound mcp` - Uses current directory as project root
+- `chunkhound mcp /path/to/project` - Uses specified path as project root
+- Database, config, and watch paths all scoped to project root
+
 **Processing pipeline:**
 Scan → Parse → Index → Embed → Search
 

{chunkhound-2.4.2 → chunkhound-2.4.4}/chunkhound/api/cli/commands/mcp.py

@@ -21,16 +21,31 @@ def mcp_command(args: argparse.Namespace) -> None:
     )
     cmd = [sys.executable, str(mcp_launcher_path)]
 
-    # Only pass --db argument if explicitly provided, otherwise let unified config handle it
-    if args.db is not None:
-        cmd.extend(["--db", str(args.db)])
-
-    # Pass the path argument as watch-path if provided and not current directory
+    # Handle positional path argument for complete project scope control
     if hasattr(args, 'path') and args.path != Path("."):
-        cmd.extend(["--watch-path", str(args.path.resolve())])
+        project_path = args.path.resolve()
+        
+        # Set database path to <path>/.chunkhound/db if not explicitly provided
+        if args.db is None:
+            db_path = project_path / ".chunkhound" / "db"
+            cmd.extend(["--db", str(db_path)])
+        else:
+            cmd.extend(["--db", str(args.db)])
+        
+        # Set watch path to the project directory
+        cmd.extend(["--watch-path", str(project_path)])
+        
+    else:
+        # Only pass --db argument if explicitly provided, otherwise let unified config handle it
+        if args.db is not None:
+            cmd.extend(["--db", str(args.db)])
 
     # Inherit current environment - the centralized config will handle API keys
     env = os.environ.copy()
+    
+    # Set environment variable for config file search in project directory if path provided
+    if hasattr(args, 'path') and args.path != Path("."):
+        env["CHUNKHOUND_PROJECT_ROOT"] = str(args.path.resolve())
 
     process = subprocess.run(
         cmd,

{chunkhound-2.4.2 → chunkhound-2.4.4}/chunkhound/core/config/config.py

@@ -61,6 +61,11 @@ class Config(BaseModel):
                 self._deep_merge(config_data, file_config)
         
         # 3. Check for .chunkhound.json in target directory
+        # First check CHUNKHOUND_PROJECT_ROOT if set (from positional path argument)
+        project_root = os.environ.get("CHUNKHOUND_PROJECT_ROOT")
+        if project_root:
+            target_dir = Path(project_root)
+        
         if target_dir and target_dir.exists():
             local_config_path = target_dir / ".chunkhound.json"
             if local_config_path.exists():

{chunkhound-2.4.2 → chunkhound-2.4.4}/chunkhound/mcp_server.py

@@ -385,18 +385,15 @@ async def server_lifespan(server: Server) -> AsyncIterator[dict]:
                 # )
 
                 pass
-            # Get base directory from environment or use current working directory
-            base_directory = Path(os.getcwd())
-
             # Use the SAME IndexingCoordinator instance from _database to ensure deduplication
             # This prevents duplicate entries by sharing the same ChunkCacheService state
             indexing_coordinator = _database._indexing_coordinator
 
             # Create periodic indexer with environment configuration
+            # Let from_environment() handle path resolution using the same logic as FileWatcherManager
             _periodic_indexer = PeriodicIndexManager.from_environment(
                 indexing_coordinator=indexing_coordinator,
                 task_coordinator=_task_coordinator,
-                base_directory=base_directory,
             )
 
             # Start periodic indexer (immediate startup scan + periodic scans)

{chunkhound-2.4.2 → chunkhound-2.4.4}/chunkhound/periodic_indexer.py

@@ -70,7 +70,7 @@ class PeriodicIndexManager:
         cls,
         indexing_coordinator,
         task_coordinator: TaskCoordinator,
-        base_directory: Path,
+        base_directory: Path | None = None,
     ) -> "PeriodicIndexManager":
         """Create periodic index manager from environment variables.
 
@@ -78,11 +78,12 @@ class PeriodicIndexManager:
             CHUNKHOUND_PERIODIC_INDEX_INTERVAL: Scan interval in seconds (default: 300)
             CHUNKHOUND_PERIODIC_BATCH_SIZE: Files per batch (default: 10)
             CHUNKHOUND_PERIODIC_INDEX_ENABLED: Enable/disable (default: true)
+            CHUNKHOUND_WATCH_PATHS: Paths to watch (defaults to project root)
 
         Args:
             indexing_coordinator: IndexingCoordinator instance
             task_coordinator: TaskCoordinator instance
-            base_directory: Base directory to scan
+            base_directory: Base directory to scan (defaults to same logic as FileWatcherManager)
 
         Returns:
             Configured PeriodicIndexManager instance
@@ -96,6 +97,24 @@ class PeriodicIndexManager:
             os.getenv("CHUNKHOUND_PERIODIC_INDEX_ENABLED", "true").lower() == "true"
         )
 
+        # Use the same path resolution logic as FileWatcherManager
+        if base_directory is None:
+            try:
+                from .utils.project_detection import get_project_watch_paths
+                watch_paths = get_project_watch_paths()
+                base_directory = watch_paths[0] if watch_paths else Path.cwd()
+            except ImportError:
+                # Fallback to environment variable check
+                paths_env = os.environ.get("CHUNKHOUND_WATCH_PATHS", "")
+                if paths_env:
+                    path_strings = [p.strip() for p in paths_env.split(",") if p.strip()]
+                    if path_strings:
+                        base_directory = Path(path_strings[0]).resolve()
+                    else:
+                        base_directory = Path.cwd()
+                else:
+                    base_directory = Path.cwd()
+
         return cls(
             indexing_coordinator=indexing_coordinator,
             task_coordinator=task_coordinator,

{chunkhound-2.4.2 → chunkhound-2.4.4}/chunkhound/version.py

@@ -1,3 +1,3 @@
 """Single source of truth for ChunkHound version."""
 
-__version__ = "2.4.2"
+__version__ = "2.4.4"

{chunkhound-2.4.2 → chunkhound-2.4.4}/mcp_launcher.py

@@ -102,11 +102,9 @@ def main():
     # Set up watch paths for filesystem monitoring
     setup_watch_paths(args)
 
-    # Change to the watch directory if specified
-    if args.watch_path:
-        watch_path = Path(args.watch_path).resolve()
-        if watch_path.exists() and watch_path.is_dir():
-            os.chdir(watch_path)
+    # Note: Removed os.chdir() to avoid breaking imports and permissions issues
+    # The watch path is already handled via CHUNKHOUND_WATCH_PATHS environment variable
+    # and all path operations should use absolute paths
 
     # Import and run the MCP entry point
     try:

{chunkhound-2.4.2 → chunkhound-2.4.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "chunkhound"
-version = "2.4.2"
+version = "2.4.4"
 description = "Local-first semantic code search with vector and regex capabilities for AI assistants via MCP"
 readme = "README.md"
 requires-python = ">=3.10"