English Français العربية

com.knitli/codeweaver

Official registry Archived Developer tools

Semantic code search built for AI agents. Hybrid, AST-aware, context for 166 languages.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package code-weaver
Claude Code 
claude mcp add codeweaver -e 'CODEWEAVER_CONFIG_FILE=<CODEWEAVER_CONFIG_FILE>' -e 'CODEWEAVER_DEBUG=false' -e 'CODEWEAVER_EMBEDDING_API_KEY=<your codeweaver_embedding_api_key>' -e 'CODEWEAVER_EMBEDDING_MODEL=voyage-code-3' -e 'CODEWEAVER_EMBEDDING_PROVIDER=voyage' -e 'CODEWEAVER_HOST=localhost' -e 'CODEWEAVER_LOG_LEVEL=WARNING' -e 'CODEWEAVER_MCP_PORT=9328' -e 'CODEWEAVER_PORT=9329' -e 'CODEWEAVER_PROFILE=<CODEWEAVER_PROFILE>' -e 'CODEWEAVER_PROJECT_NAME=<CODEWEAVER_PROJECT_NAME>' -e 'CODEWEAVER_PROJECT_PATH=<CODEWEAVER_PROJECT_PATH>' -e 'CODEWEAVER_RERANKING_API_KEY=<your codeweaver_reranking_api_key>' -e 'CODEWEAVER_RERANKING_MODEL=rerank-2.5' -e 'CODEWEAVER_RERANKING_PROVIDER=voyage' -e 'CODEWEAVER_SPARSE_EMBEDDING_MODEL=prithivida/Splade_pp_en_v1' -e 'CODEWEAVER_SPARSE_EMBEDDING_PROVIDER=fastembed' -e 'CODEWEAVER_VECTOR_STORE_API_KEY=<your codeweaver_vector_store_api_key>' -e 'CODEWEAVER_VECTOR_STORE_PORT=6333' -e 'CODEWEAVER_VECTOR_STORE_PROVIDER=qdrant' -e 'CODEWEAVER_VECTOR_STORE_URL=http://localhost' -e 'CODEWEAVER__TELEMETRY__DISABLE_TELEMETRY=false' -e 'CODEWEAVER__TELEMETRY__TOOLS_OVER_PRIVACY=false' -e 'HTTPS_PROXY=<HTTPS_PROXY>' -e 'OPENAI_API_KEY=<your openai_api_key>' -e 'OPENAI_LOG=<OPENAI_LOG>' -e 'SSL_CERT_FILE=<SSL_CERT_FILE>' -e 'AI_GATEWAY_API_KEY=<your ai_gateway_api_key>' -e 'AWS_ACCOUNT_ID=<AWS_ACCOUNT_ID>' -e 'AWS_REGION=<AWS_REGION>' -e 'AWS_SECRET_ACCESS_KEY=<your aws_secret_access_key>' -e 'AZURE_COHERE_API_KEY=<your azure_cohere_api_key>' -e 'AZURE_COHERE_ENDPOINT=<AZURE_COHERE_ENDPOINT>' -e 'AZURE_COHERE_REGION=<AZURE_COHERE_REGION>' -e 'AZURE_OPENAI_API_KEY=<your azure_openai_api_key>' -e 'AZURE_OPENAI_ENDPOINT=<AZURE_OPENAI_ENDPOINT>' -e 'AZURE_OPENAI_REGION=<AZURE_OPENAI_REGION>' -e 'COHERE_API_KEY=<COHERE_API_KEY>' -e 'CO_API_URL=<CO_API_URL>' -e 'DEEPSEEK_API_KEY=<your deepseek_api_key>' -e 'GEMINI_API_KEY=<GEMINI_API_KEY>' -e 'GOOGLE_API_KEY=<GOOGLE_API_KEY>' -e 'HF_HUB_VERBOSITY=<HF_HUB_VERBOSITY>' -e 'HF_TOKEN=<HF_TOKEN>' -e 'INFERENCE_KEY=<your inference_key>' -e 'INFERENCE_URL=<INFERENCE_URL>' -e 'MISTRAL_API_KEY=<MISTRAL_API_KEY>' -e 'QDRANT__LOG_LEVEL=<QDRANT__LOG_LEVEL>' -e 'QDRANT__SERVICE__API_KEY=<your qdrant__service__api_key>' -e 'QDRANT__SERVICE__ENABLE_TLS=<QDRANT__SERVICE__ENABLE_TLS>' -e 'QDRANT__SERVICE__HOST=<QDRANT__SERVICE__HOST>' -e 'QDRANT__SERVICE__HTTP_PORT=<QDRANT__SERVICE__HTTP_PORT>' -e 'QDRANT__TLS__CERT=<QDRANT__TLS__CERT>' -e 'TAVILY_API_KEY=<TAVILY_API_KEY>' -e 'TOGETHER_API_KEY=<your together_api_key>' -e 'VERCEL_OIDC_TOKEN=<your vercel_oidc_token>' -e 'VOYAGE_API_KEY=<your voyage_api_key>' -- uvx code-weaver==0.1.0a3 server --project '<path>' --config '<file_path>' --host '<host>' --port '<port>' --transport --verbose --debug
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "codeweaver": {
            "command": "uvx",
            "args": [
                "code-weaver==0.1.0a3",
                "server",
                "--project",
                "<path>",
                "--config",
                "<file_path>",
                "--host",
                "<host>",
                "--port",
                "<port>",
                "--transport",
                "--verbose",
                "--debug"
            ],
            "env": {
                "CODEWEAVER_CONFIG_FILE": "<CODEWEAVER_CONFIG_FILE>",
                "CODEWEAVER_DEBUG": "false",
                "CODEWEAVER_EMBEDDING_API_KEY": "<your codeweaver_embedding_api_key>",
                "CODEWEAVER_EMBEDDING_MODEL": "voyage-code-3",
                "CODEWEAVER_EMBEDDING_PROVIDER": "voyage",
                "CODEWEAVER_HOST": "localhost",
                "CODEWEAVER_LOG_LEVEL": "WARNING",
                "CODEWEAVER_MCP_PORT": "9328",
                "CODEWEAVER_PORT": "9329",
                "CODEWEAVER_PROFILE": "<CODEWEAVER_PROFILE>",
                "CODEWEAVER_PROJECT_NAME": "<CODEWEAVER_PROJECT_NAME>",
                "CODEWEAVER_PROJECT_PATH": "<CODEWEAVER_PROJECT_PATH>",
                "CODEWEAVER_RERANKING_API_KEY": "<your codeweaver_reranking_api_key>",
                "CODEWEAVER_RERANKING_MODEL": "rerank-2.5",
                "CODEWEAVER_RERANKING_PROVIDER": "voyage",
                "CODEWEAVER_SPARSE_EMBEDDING_MODEL": "prithivida/Splade_pp_en_v1",
                "CODEWEAVER_SPARSE_EMBEDDING_PROVIDER": "fastembed",
                "CODEWEAVER_VECTOR_STORE_API_KEY": "<your codeweaver_vector_store_api_key>",
                "CODEWEAVER_VECTOR_STORE_PORT": "6333",
                "CODEWEAVER_VECTOR_STORE_PROVIDER": "qdrant",
                "CODEWEAVER_VECTOR_STORE_URL": "http://localhost",
                "CODEWEAVER__TELEMETRY__DISABLE_TELEMETRY": "false",
                "CODEWEAVER__TELEMETRY__TOOLS_OVER_PRIVACY": "false",
                "HTTPS_PROXY": "<HTTPS_PROXY>",
                "OPENAI_API_KEY": "<your openai_api_key>",
                "OPENAI_LOG": "<OPENAI_LOG>",
                "SSL_CERT_FILE": "<SSL_CERT_FILE>",
                "AI_GATEWAY_API_KEY": "<your ai_gateway_api_key>",
                "AWS_ACCOUNT_ID": "<AWS_ACCOUNT_ID>",
                "AWS_REGION": "<AWS_REGION>",
                "AWS_SECRET_ACCESS_KEY": "<your aws_secret_access_key>",
                "AZURE_COHERE_API_KEY": "<your azure_cohere_api_key>",
                "AZURE_COHERE_ENDPOINT": "<AZURE_COHERE_ENDPOINT>",
                "AZURE_COHERE_REGION": "<AZURE_COHERE_REGION>",
                "AZURE_OPENAI_API_KEY": "<your azure_openai_api_key>",
                "AZURE_OPENAI_ENDPOINT": "<AZURE_OPENAI_ENDPOINT>",
                "AZURE_OPENAI_REGION": "<AZURE_OPENAI_REGION>",
                "COHERE_API_KEY": "<COHERE_API_KEY>",
                "CO_API_URL": "<CO_API_URL>",
                "DEEPSEEK_API_KEY": "<your deepseek_api_key>",
                "GEMINI_API_KEY": "<GEMINI_API_KEY>",
                "GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
                "HF_HUB_VERBOSITY": "<HF_HUB_VERBOSITY>",
                "HF_TOKEN": "<HF_TOKEN>",
                "INFERENCE_KEY": "<your inference_key>",
                "INFERENCE_URL": "<INFERENCE_URL>",
                "MISTRAL_API_KEY": "<MISTRAL_API_KEY>",
                "QDRANT__LOG_LEVEL": "<QDRANT__LOG_LEVEL>",
                "QDRANT__SERVICE__API_KEY": "<your qdrant__service__api_key>",
                "QDRANT__SERVICE__ENABLE_TLS": "<QDRANT__SERVICE__ENABLE_TLS>",
                "QDRANT__SERVICE__HOST": "<QDRANT__SERVICE__HOST>",
                "QDRANT__SERVICE__HTTP_PORT": "<QDRANT__SERVICE__HTTP_PORT>",
                "QDRANT__TLS__CERT": "<QDRANT__TLS__CERT>",
                "TAVILY_API_KEY": "<TAVILY_API_KEY>",
                "TOGETHER_API_KEY": "<your together_api_key>",
                "VERCEL_OIDC_TOKEN": "<your vercel_oidc_token>",
                "VOYAGE_API_KEY": "<your voyage_api_key>"
            }
        }
    }
}

Environment variables

  • CODEWEAVER_CONFIG_FILE Specify a custom config file path for CodeWeaver. Only needed if not using the default locations.
  • CODEWEAVER_DEBUG Enable debug mode for CodeWeaver.
  • CODEWEAVER_EMBEDDING_API_KEY secret Specify the API key for the embedding provider, if required. Note: {', '.join([p for p in _providers_for_kind('embedding') if p.])}
  • CODEWEAVER_EMBEDDING_MODEL Specify the embedding model to use.
  • CODEWEAVER_EMBEDDING_PROVIDER Specify the embedding provider to use.
  • CODEWEAVER_HOST Set the server host for CodeWeaver.
  • CODEWEAVER_LOG_LEVEL Set the log level for CodeWeaver (e.g., DEBUG, INFO, WARNING, ERROR).
  • CODEWEAVER_MCP_PORT Set the MCP server port for CodeWeaver if using http transport for mcp. Not required if using the default port (9328), or stdio transport.
  • CODEWEAVER_PORT Set the port for the codeweaver management server (information and management endpoints).
  • CODEWEAVER_PROFILE Use a premade provider settings profile for CodeWeaver.
  • CODEWEAVER_PROJECT_NAME Set the project name for CodeWeaver.
  • CODEWEAVER_PROJECT_PATH Set the project path for CodeWeaver.
  • CODEWEAVER_RERANKING_API_KEY secret Specify the API key for the reranking provider, if required.
  • CODEWEAVER_RERANKING_MODEL Specify the reranking model to use.
  • CODEWEAVER_RERANKING_PROVIDER Specify the reranking provider to use.
  • CODEWEAVER_SPARSE_EMBEDDING_MODEL Specify the sparse embedding model to use.
  • CODEWEAVER_SPARSE_EMBEDDING_PROVIDER Specify the sparse embedding provider to use.
  • CODEWEAVER_VECTOR_STORE_API_KEY secret Specify the API key for the vector store, if required.
  • CODEWEAVER_VECTOR_STORE_PORT Specify the port for the vector store.
  • CODEWEAVER_VECTOR_STORE_PROVIDER Specify the vector store provider to use.
  • CODEWEAVER_VECTOR_STORE_URL Specify the URL for the vector store.
  • CODEWEAVER__TELEMETRY__DISABLE_TELEMETRY Disable telemetry data collection.
  • CODEWEAVER__TELEMETRY__TOOLS_OVER_PRIVACY Opt-in to potentially identifying collection of query and search result data. This is invaluable for helping us improve CodeWeaver's search capabilities. If privacy is a higher priority, do not enable this setting.
  • HTTPS_PROXY HTTP proxy for requests (Used by: Azure, Azure, Voyage)
  • OPENAI_API_KEY secret API key for OpenAI-compatible services (not necessarily an API key *for* OpenAI). The OpenAI client also requires an API key, even if you don't actually need one for your provider (like local Ollama). So provide a dummy key if needed. (Used by: Azure, Cerebras, Deepseek, Fireworks, Github, Groq, Heroku, Moonshot, Ollama, Openai, Openrouter, Perplexity, Together, Vercel, X Ai)
  • OPENAI_LOG One of: 'debug', 'info', 'warning', 'error' (Used by: Azure, Cerebras, Deepseek, Fireworks, Github, Groq, Heroku, Moonshot, Ollama, Openai, Openrouter, Perplexity, Together, Vercel, X Ai)
  • SSL_CERT_FILE Path to the SSL certificate file for requests (Used by: Azure, Azure, Voyage)
  • AI_GATEWAY_API_KEY secret API key for Vercel service
  • AWS_ACCOUNT_ID AWS Account ID for Bedrock service
  • AWS_REGION AWS region for Bedrock service
  • AWS_SECRET_ACCESS_KEY secret AWS Secret Access Key for Bedrock service
  • AZURE_COHERE_API_KEY secret API key for Azure Cohere service (cohere models on Azure)
  • AZURE_COHERE_ENDPOINT Endpoint for Azure Cohere service (cohere models on Azure)
  • AZURE_COHERE_REGION Region for Azure Cohere service
  • AZURE_OPENAI_API_KEY secret API key for Azure OpenAI service (OpenAI models on Azure)
  • AZURE_OPENAI_ENDPOINT Endpoint for Azure OpenAI service (OpenAI models on Azure)
  • AZURE_OPENAI_REGION Region for Azure OpenAI service (OpenAI models on Azure)
  • COHERE_API_KEY Your Cohere API Key
  • CO_API_URL Host URL for Cohere service
  • DEEPSEEK_API_KEY secret API key for DeepSeek service
  • GEMINI_API_KEY Your Google Gemini API Key
  • GOOGLE_API_KEY Your Google API Key
  • HF_HUB_VERBOSITY Log level for Hugging Face Hub client
  • HF_TOKEN API key/token for Hugging Face service
  • HTTPS_PROXY HTTP proxy for requests
  • INFERENCE_KEY secret API key for Heroku service
  • INFERENCE_URL Host URL for Heroku service
  • MISTRAL_API_KEY Your Mistral API Key
  • OPENAI_API_KEY secret API key for OpenAI-compatible services (not necessarily an API key *for* OpenAI). The OpenAI client also requires an API key, even if you don't actually need one for your provider (like local Ollama). So provide a dummy key if needed.
  • OPENAI_LOG One of: 'debug', 'info', 'warning', 'error'
  • QDRANT__LOG_LEVEL Log level for Qdrant service
  • QDRANT__SERVICE__API_KEY secret API key for Qdrant service
  • QDRANT__SERVICE__ENABLE_TLS Enable TLS for Qdrant service, expects truthy or false value (e.g. 1 for on, 0 for off).
  • QDRANT__SERVICE__HOST Hostname of the Qdrant service; do not use for URLs with schemes (e.g. 'http://')
  • QDRANT__SERVICE__HTTP_PORT Port number for the Qdrant service
  • QDRANT__TLS__CERT Path to the TLS certificate file for Qdrant service. Only needed if using a self-signed certificate. If you're using qdrant-cloud, you don't need this.
  • SSL_CERT_FILE Path to the SSL certificate file for requests
  • TAVILY_API_KEY Your Tavily API Key
  • TOGETHER_API_KEY secret API key for Together service
  • VERCEL_OIDC_TOKEN secret OIDC token for Vercel service
  • VOYAGE_API_KEY secret API key for Voyage service
OCI package docker.io/knitli/codeweaver:0.1.0-alpha.3
Claude Code 
claude mcp add codeweaver -e 'CODEWEAVER_CONFIG_FILE=<CODEWEAVER_CONFIG_FILE>' -e 'CODEWEAVER_DEBUG=false' -e 'CODEWEAVER_EMBEDDING_API_KEY=<your codeweaver_embedding_api_key>' -e 'CODEWEAVER_EMBEDDING_MODEL=voyage-code-3' -e 'CODEWEAVER_EMBEDDING_PROVIDER=voyage' -e 'CODEWEAVER_HOST=localhost' -e 'CODEWEAVER_LOG_LEVEL=WARNING' -e 'CODEWEAVER_MCP_PORT=9328' -e 'CODEWEAVER_PORT=9329' -e 'CODEWEAVER_PROFILE=<CODEWEAVER_PROFILE>' -e 'CODEWEAVER_PROJECT_NAME=<CODEWEAVER_PROJECT_NAME>' -e 'CODEWEAVER_PROJECT_PATH=<CODEWEAVER_PROJECT_PATH>' -e 'CODEWEAVER_RERANKING_API_KEY=<your codeweaver_reranking_api_key>' -e 'CODEWEAVER_RERANKING_MODEL=rerank-2.5' -e 'CODEWEAVER_RERANKING_PROVIDER=voyage' -e 'CODEWEAVER_SPARSE_EMBEDDING_MODEL=prithivida/Splade_pp_en_v1' -e 'CODEWEAVER_SPARSE_EMBEDDING_PROVIDER=fastembed' -e 'CODEWEAVER_VECTOR_STORE_API_KEY=<your codeweaver_vector_store_api_key>' -e 'CODEWEAVER_VECTOR_STORE_PORT=6333' -e 'CODEWEAVER_VECTOR_STORE_PROVIDER=qdrant' -e 'CODEWEAVER_VECTOR_STORE_URL=http://localhost' -e 'CODEWEAVER__TELEMETRY__DISABLE_TELEMETRY=false' -e 'CODEWEAVER__TELEMETRY__TOOLS_OVER_PRIVACY=false' -e 'HTTPS_PROXY=<HTTPS_PROXY>' -e 'OPENAI_API_KEY=<your openai_api_key>' -e 'OPENAI_LOG=<OPENAI_LOG>' -e 'SSL_CERT_FILE=<SSL_CERT_FILE>' -e 'AI_GATEWAY_API_KEY=<your ai_gateway_api_key>' -e 'AWS_ACCOUNT_ID=<AWS_ACCOUNT_ID>' -e 'AWS_REGION=<AWS_REGION>' -e 'AWS_SECRET_ACCESS_KEY=<your aws_secret_access_key>' -e 'AZURE_COHERE_API_KEY=<your azure_cohere_api_key>' -e 'AZURE_COHERE_ENDPOINT=<AZURE_COHERE_ENDPOINT>' -e 'AZURE_COHERE_REGION=<AZURE_COHERE_REGION>' -e 'AZURE_OPENAI_API_KEY=<your azure_openai_api_key>' -e 'AZURE_OPENAI_ENDPOINT=<AZURE_OPENAI_ENDPOINT>' -e 'AZURE_OPENAI_REGION=<AZURE_OPENAI_REGION>' -e 'COHERE_API_KEY=<COHERE_API_KEY>' -e 'CO_API_URL=<CO_API_URL>' -e 'DEEPSEEK_API_KEY=<your deepseek_api_key>' -e 'GEMINI_API_KEY=<GEMINI_API_KEY>' -e 'GOOGLE_API_KEY=<GOOGLE_API_KEY>' -e 'HF_HUB_VERBOSITY=<HF_HUB_VERBOSITY>' -e 'HF_TOKEN=<HF_TOKEN>' -e 'INFERENCE_KEY=<your inference_key>' -e 'INFERENCE_URL=<INFERENCE_URL>' -e 'MISTRAL_API_KEY=<MISTRAL_API_KEY>' -e 'QDRANT__LOG_LEVEL=<QDRANT__LOG_LEVEL>' -e 'QDRANT__SERVICE__API_KEY=<your qdrant__service__api_key>' -e 'QDRANT__SERVICE__ENABLE_TLS=<QDRANT__SERVICE__ENABLE_TLS>' -e 'QDRANT__SERVICE__HOST=<QDRANT__SERVICE__HOST>' -e 'QDRANT__SERVICE__HTTP_PORT=<QDRANT__SERVICE__HTTP_PORT>' -e 'QDRANT__TLS__CERT=<QDRANT__TLS__CERT>' -e 'TAVILY_API_KEY=<TAVILY_API_KEY>' -e 'TOGETHER_API_KEY=<your together_api_key>' -e 'VERCEL_OIDC_TOKEN=<your vercel_oidc_token>' -e 'VOYAGE_API_KEY=<your voyage_api_key>' -- docker run -i --rm docker.io/knitli/codeweaver:0.1.0-alpha.3 server --host 0.0.0.0 --port 9328 --transport
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "codeweaver": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/knitli/codeweaver:0.1.0-alpha.3",
                "server",
                "--host",
                "0.0.0.0",
                "--port",
                "9328",
                "--transport"
            ],
            "env": {
                "CODEWEAVER_CONFIG_FILE": "<CODEWEAVER_CONFIG_FILE>",
                "CODEWEAVER_DEBUG": "false",
                "CODEWEAVER_EMBEDDING_API_KEY": "<your codeweaver_embedding_api_key>",
                "CODEWEAVER_EMBEDDING_MODEL": "voyage-code-3",
                "CODEWEAVER_EMBEDDING_PROVIDER": "voyage",
                "CODEWEAVER_HOST": "localhost",
                "CODEWEAVER_LOG_LEVEL": "WARNING",
                "CODEWEAVER_MCP_PORT": "9328",
                "CODEWEAVER_PORT": "9329",
                "CODEWEAVER_PROFILE": "<CODEWEAVER_PROFILE>",
                "CODEWEAVER_PROJECT_NAME": "<CODEWEAVER_PROJECT_NAME>",
                "CODEWEAVER_PROJECT_PATH": "<CODEWEAVER_PROJECT_PATH>",
                "CODEWEAVER_RERANKING_API_KEY": "<your codeweaver_reranking_api_key>",
                "CODEWEAVER_RERANKING_MODEL": "rerank-2.5",
                "CODEWEAVER_RERANKING_PROVIDER": "voyage",
                "CODEWEAVER_SPARSE_EMBEDDING_MODEL": "prithivida/Splade_pp_en_v1",
                "CODEWEAVER_SPARSE_EMBEDDING_PROVIDER": "fastembed",
                "CODEWEAVER_VECTOR_STORE_API_KEY": "<your codeweaver_vector_store_api_key>",
                "CODEWEAVER_VECTOR_STORE_PORT": "6333",
                "CODEWEAVER_VECTOR_STORE_PROVIDER": "qdrant",
                "CODEWEAVER_VECTOR_STORE_URL": "http://localhost",
                "CODEWEAVER__TELEMETRY__DISABLE_TELEMETRY": "false",
                "CODEWEAVER__TELEMETRY__TOOLS_OVER_PRIVACY": "false",
                "HTTPS_PROXY": "<HTTPS_PROXY>",
                "OPENAI_API_KEY": "<your openai_api_key>",
                "OPENAI_LOG": "<OPENAI_LOG>",
                "SSL_CERT_FILE": "<SSL_CERT_FILE>",
                "AI_GATEWAY_API_KEY": "<your ai_gateway_api_key>",
                "AWS_ACCOUNT_ID": "<AWS_ACCOUNT_ID>",
                "AWS_REGION": "<AWS_REGION>",
                "AWS_SECRET_ACCESS_KEY": "<your aws_secret_access_key>",
                "AZURE_COHERE_API_KEY": "<your azure_cohere_api_key>",
                "AZURE_COHERE_ENDPOINT": "<AZURE_COHERE_ENDPOINT>",
                "AZURE_COHERE_REGION": "<AZURE_COHERE_REGION>",
                "AZURE_OPENAI_API_KEY": "<your azure_openai_api_key>",
                "AZURE_OPENAI_ENDPOINT": "<AZURE_OPENAI_ENDPOINT>",
                "AZURE_OPENAI_REGION": "<AZURE_OPENAI_REGION>",
                "COHERE_API_KEY": "<COHERE_API_KEY>",
                "CO_API_URL": "<CO_API_URL>",
                "DEEPSEEK_API_KEY": "<your deepseek_api_key>",
                "GEMINI_API_KEY": "<GEMINI_API_KEY>",
                "GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
                "HF_HUB_VERBOSITY": "<HF_HUB_VERBOSITY>",
                "HF_TOKEN": "<HF_TOKEN>",
                "INFERENCE_KEY": "<your inference_key>",
                "INFERENCE_URL": "<INFERENCE_URL>",
                "MISTRAL_API_KEY": "<MISTRAL_API_KEY>",
                "QDRANT__LOG_LEVEL": "<QDRANT__LOG_LEVEL>",
                "QDRANT__SERVICE__API_KEY": "<your qdrant__service__api_key>",
                "QDRANT__SERVICE__ENABLE_TLS": "<QDRANT__SERVICE__ENABLE_TLS>",
                "QDRANT__SERVICE__HOST": "<QDRANT__SERVICE__HOST>",
                "QDRANT__SERVICE__HTTP_PORT": "<QDRANT__SERVICE__HTTP_PORT>",
                "QDRANT__TLS__CERT": "<QDRANT__TLS__CERT>",
                "TAVILY_API_KEY": "<TAVILY_API_KEY>",
                "TOGETHER_API_KEY": "<your together_api_key>",
                "VERCEL_OIDC_TOKEN": "<your vercel_oidc_token>",
                "VOYAGE_API_KEY": "<your voyage_api_key>"
            }
        }
    }
}

Environment variables

  • CODEWEAVER_CONFIG_FILE Specify a custom config file path for CodeWeaver. Only needed if not using the default locations.
  • CODEWEAVER_DEBUG Enable debug mode for CodeWeaver.
  • CODEWEAVER_EMBEDDING_API_KEY secret Specify the API key for the embedding provider, if required. Note: {', '.join([p for p in _providers_for_kind('embedding') if p.])}
  • CODEWEAVER_EMBEDDING_MODEL Specify the embedding model to use.
  • CODEWEAVER_EMBEDDING_PROVIDER Specify the embedding provider to use.
  • CODEWEAVER_HOST Set the server host for CodeWeaver.
  • CODEWEAVER_LOG_LEVEL Set the log level for CodeWeaver (e.g., DEBUG, INFO, WARNING, ERROR).
  • CODEWEAVER_MCP_PORT Set the MCP server port for CodeWeaver if using http transport for mcp. Not required if using the default port (9328), or stdio transport.
  • CODEWEAVER_PORT Set the port for the codeweaver management server (information and management endpoints).
  • CODEWEAVER_PROFILE Use a premade provider settings profile for CodeWeaver.
  • CODEWEAVER_PROJECT_NAME Set the project name for CodeWeaver.
  • CODEWEAVER_PROJECT_PATH Set the project path for CodeWeaver.
  • CODEWEAVER_RERANKING_API_KEY secret Specify the API key for the reranking provider, if required.
  • CODEWEAVER_RERANKING_MODEL Specify the reranking model to use.
  • CODEWEAVER_RERANKING_PROVIDER Specify the reranking provider to use.
  • CODEWEAVER_SPARSE_EMBEDDING_MODEL Specify the sparse embedding model to use.
  • CODEWEAVER_SPARSE_EMBEDDING_PROVIDER Specify the sparse embedding provider to use.
  • CODEWEAVER_VECTOR_STORE_API_KEY secret Specify the API key for the vector store, if required.
  • CODEWEAVER_VECTOR_STORE_PORT Specify the port for the vector store.
  • CODEWEAVER_VECTOR_STORE_PROVIDER Specify the vector store provider to use.
  • CODEWEAVER_VECTOR_STORE_URL Specify the URL for the vector store.
  • CODEWEAVER__TELEMETRY__DISABLE_TELEMETRY Disable telemetry data collection.
  • CODEWEAVER__TELEMETRY__TOOLS_OVER_PRIVACY Opt-in to potentially identifying collection of query and search result data. This is invaluable for helping us improve CodeWeaver's search capabilities. If privacy is a higher priority, do not enable this setting.
  • HTTPS_PROXY HTTP proxy for requests (Used by: Azure, Azure, Voyage)
  • OPENAI_API_KEY secret API key for OpenAI-compatible services (not necessarily an API key *for* OpenAI). The OpenAI client also requires an API key, even if you don't actually need one for your provider (like local Ollama). So provide a dummy key if needed. (Used by: Azure, Cerebras, Deepseek, Fireworks, Github, Groq, Heroku, Moonshot, Ollama, Openai, Openrouter, Perplexity, Together, Vercel, X Ai)
  • OPENAI_LOG One of: 'debug', 'info', 'warning', 'error' (Used by: Azure, Cerebras, Deepseek, Fireworks, Github, Groq, Heroku, Moonshot, Ollama, Openai, Openrouter, Perplexity, Together, Vercel, X Ai)
  • SSL_CERT_FILE Path to the SSL certificate file for requests (Used by: Azure, Azure, Voyage)
  • AI_GATEWAY_API_KEY secret API key for Vercel service
  • AWS_ACCOUNT_ID AWS Account ID for Bedrock service
  • AWS_REGION AWS region for Bedrock service
  • AWS_SECRET_ACCESS_KEY secret AWS Secret Access Key for Bedrock service
  • AZURE_COHERE_API_KEY secret API key for Azure Cohere service (cohere models on Azure)
  • AZURE_COHERE_ENDPOINT Endpoint for Azure Cohere service (cohere models on Azure)
  • AZURE_COHERE_REGION Region for Azure Cohere service
  • AZURE_OPENAI_API_KEY secret API key for Azure OpenAI service (OpenAI models on Azure)
  • AZURE_OPENAI_ENDPOINT Endpoint for Azure OpenAI service (OpenAI models on Azure)
  • AZURE_OPENAI_REGION Region for Azure OpenAI service (OpenAI models on Azure)
  • COHERE_API_KEY Your Cohere API Key
  • CO_API_URL Host URL for Cohere service
  • DEEPSEEK_API_KEY secret API key for DeepSeek service
  • GEMINI_API_KEY Your Google Gemini API Key
  • GOOGLE_API_KEY Your Google API Key
  • HF_HUB_VERBOSITY Log level for Hugging Face Hub client
  • HF_TOKEN API key/token for Hugging Face service
  • HTTPS_PROXY HTTP proxy for requests
  • INFERENCE_KEY secret API key for Heroku service
  • INFERENCE_URL Host URL for Heroku service
  • MISTRAL_API_KEY Your Mistral API Key
  • OPENAI_API_KEY secret API key for OpenAI-compatible services (not necessarily an API key *for* OpenAI). The OpenAI client also requires an API key, even if you don't actually need one for your provider (like local Ollama). So provide a dummy key if needed.
  • OPENAI_LOG One of: 'debug', 'info', 'warning', 'error'
  • QDRANT__LOG_LEVEL Log level for Qdrant service
  • QDRANT__SERVICE__API_KEY secret API key for Qdrant service
  • QDRANT__SERVICE__ENABLE_TLS Enable TLS for Qdrant service, expects truthy or false value (e.g. 1 for on, 0 for off).
  • QDRANT__SERVICE__HOST Hostname of the Qdrant service; do not use for URLs with schemes (e.g. 'http://')
  • QDRANT__SERVICE__HTTP_PORT Port number for the Qdrant service
  • QDRANT__TLS__CERT Path to the TLS certificate file for Qdrant service. Only needed if using a self-signed certificate. If you're using qdrant-cloud, you don't need this.
  • SSL_CERT_FILE Path to the SSL certificate file for requests
  • TAVILY_API_KEY Your Tavily API Key
  • TOGETHER_API_KEY secret API key for Together service
  • VERCEL_OIDC_TOKEN secret OIDC token for Vercel service
  • VOYAGE_API_KEY secret API key for Voyage service

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. CodeWeaver is no longer maintained
  2. CodeWeaver
  3. What It Does
  4. How CodeWeaver Stacks Up
  5. 🚀 Getting Started
  6. ✨ Features
  7. 💭 Philosophy: Context is Oxygen

[!WARNING]

CodeWeaver is no longer maintained

We're really proud of CodeWeaver and think it's pretty awesome, but we can't maintain it anymore.

We're focused on something else.

CodeWeaver is (was?) a sophisticated, smart, code search tool with wide provider support. and it's still licensed under your choice of MIT or Apache-2.0.

So please, fork it and build something great!

CodeWeaver

Exquisite Context for Agents — Infrastructure that is Extensible, Predictable, and Resilient.

[![Python Version][badge_python]][link_python] [![License][badge_license]][link_license] [![Release][badge_release]][link_release] [![MCP Compatible][badge_mcp]][link_mcp]

[Documentation][nav_docs] • [Installation][nav_install] • [Features][nav_features] • [Comparison][nav_comparison]

What It Does

CodeWeaver gives Claude and other AI agents precise context from your codebase. Not keyword grep. Not whole-file dumps. Actual structural understanding through hybrid semantic search.

CodeWeaver is Professional Context Infrastructure. With 100% Dependency Injection (DI) and a Pydantic-driven configuration system, it provides the reliability and extensibility required for industrial-grade AI deployments.

Example:

Without CodeWeaver:
  Claude: "Let me search for 'auth'... here are 50 files mentioning authentication"
  Result: Generic code, wrong context, wasted tokens

With CodeWeaver:
  You: "Where do we validate OAuth tokens?"
  Claude gets: The exact 3 functions across 2 files, with surrounding context
  Result: Precise answers, focused context, 60-80% token reduction

CodeWeaver is no longer in alpha!

Early Release (0.x): CodeWeaver is in active development. APIs may change between minor versions. It's very well-tested but still in 'it works on my machine' territory. [Use it, break it, help shape it][issues].

How CodeWeaver Stacks Up

Quick Reference Matrix
FeatureCodeWeaverLegacy Search Tools
Search TypeHybrid (Semantic + AST + Keyword)Keyword Only
Context QualityExquisite / High-PrecisionNoisy / Irrelevant
ExtensibilityDI-Driven (Zero-Code Provider Swap)Hardcoded
ReliabilityResilient (Automatic Local Fallback)Fails on API Timeout
Token UsageOptimized (60–80% Reduction)Wasted on Noise

🚀 Getting Started

Quick Install

Using the CLI with [uv][uv_tool]:

# Add CodeWeaver to your project
uv add code-weaver

# Initialize with a profile (recommended uses Voyage AI)
cw init --profile recommended

# Verify setup
cw doctor

# Start the background daemon
cw start

📝 Note: cw init supports different Profiles:

  • recommended: High-precision search (Voyage AI + Qdrant)
  • quickstart: 100% local, private, and free (FastEmbed + Local Qdrant)

Want full offline? See the [Local-Only Guide][local_only_guide].

🐳 Prefer Docker? [See Docker setup guide →][docker_guide]

✨ Features

🔍 Exquisite Context
  • Hybrid search (sparse + dense vectors)
  • AST-level understanding (27 languages)
  • Reciprocal Rank Fusion (RRF)
  • Language-aware chunking (166+ languages)
🛡️ Industrial Resilience
  • Automatic local fallback (FastEmbed)
  • Circuit breaker pattern for APIs
  • Works airgapped (no cloud required)
  • Pydantic-driven validation at boot-time
🧩 Universal Extensibility
  • 100% DI-driven architecture
  • 17+ integrated providers
  • Custom provider API
  • Zero-code provider swapping
🛠️ Developer Experience
  • Live indexing with file watching
  • Diagnostic tool (cw doctor)
  • Multiple CLI aliases (cw / codeweaver)
  • Selectable profiles for easy setup

💭 Philosophy: Context is Oxygen

AI agents face too much irrelevant context, causing token waste, missed patterns, and hallucinations. CodeWeaver addresses this with one focused capability: structural + semantic code understanding that you control.

  • Curation over Collection: Give agents exactly what they need, nothing more.
  • Privacy-First: Your code stays local if you want it to.
  • Infrastructure over Tooling: Built to be the reliable foundation for your AI stack.

📖 [Read the detailed rationale →][why_codeweaver]

Official Documentation: docs.knitli.com/codeweaver/

Built with ❤️ by [Knitli][knitli_site]

[⬆ Back to top][nav_top]

[badge_license]: https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-green.svg "License Badge" [badge_mcp]: https://img.shields.io/badge/MCP-compatible-purple.svg "MCP Compatible Badge" [badge_python]: https://img.shields.io/badge/python-3.12%2B-blue.svg "Python Version Badge" [badge_release]: https://img.shields.io/pypi/v/code-weaver.svg "PyPI Version"

[api_find_code]: <src/codeweaver/agent_api/find_code/README.md> "find_code API Documentation" [arch_find_code]: <src/codeweaver/agent_api/find_code/ARCHITECTURE.md> "find_code Architecture" [bashandbone]: https://github.com/bashandbone "Adam Poulemanos' GitHub Profile" [codecov]: https://codecov.io/gh/knitli/codeweaver/graph/badge.svg?token=EO3DQVHVVH "Code Coverage" [changelog]: https://github.com/knitli/codeweaver/blob/main/CHANGELOG.md "Changelog" [cla]: <CONTRIBUTORS_LICENSE_AGREEMENT.md> "Contributor License Agreement" [cli_guide]: <docs/CLI.md> "Command Line Reference" [config_schema]: <schema/codeweaver.schema.json> "The CodeWeaver Config Schema" [docker_guide]: https://docs.knitli.com/codeweaver/guides/docker/ "Docker Setup Guide" [docker_notes]: <docs/docker/DOCKER_BUILD_NOTES.md> "Docker Build Notes" [enhancement_label]: https://github.com/knitli/codeweaver/labels/enhancement "Enhancement Issues" [issues]: https://github.com/knitli/codeweaver/issues "Report an Issue" [knitli_blog]: https://blog.knitli.com "Knitli Blog" [knitli_github]: https://github.com/knitli "Knitli GitHub Organization" [knitli_linkedin]: https://linkedin.com/company/knitli "Knitli LinkedIn" [knitli_site]: https://knitli.com "Knitli Website" [knitli_x]: https://x.com/knitli_inc "Knitli X/Twitter" [link_license]: <LICENSE> "License File" [link_mcp]: https://modelcontextprotocol.io "Model Context Protocol Website" [link_python]: https://www.python.org/downloads/ "Python Downloads" [link_release]: https://github.com/knitli/codeweaver/releases "CodeWeaver Releases" [mcp]: https://modelcontextprotocol.io "Learn About the Model Context Protocol" [local_only_guide]: https://docs.knitli.com/codeweaver/guides/local-only/ "Local-Only Operation Guide" [nav_contributing]: <#-contributing> "Contributing Section" [nav_docs]: https://docs.knitli.com/codeweaver/ "CodeWeaver Documentation" [nav_comparison]: <#-quick_reference_matrix> "How CodeWeaver Compares" [nav_features]: <#-features> "Features Section" [nav_how_it_works]: <#-how-it-works> "How It Works Section" [nav_install]: <#-getting-started> "Installation Section" [nav_top]: <#codeweaver> "Back to Top" [privacy_policy]: <PRIVACY_POLICY.md> "Privacy Policy" [providers_list]: <overrides/partials/providers.md> "Full Provider List" [qdrant]: https://qdrant.tech "Qdrant Website" [repo]: https://github.com/knitli/codeweaver "CodeWeaver Repository" [reuse_spec]: https://reuse.software "REUSE Specification" [sbom]: <sbom.spdx> "Software Bill of Materials" [sponsor]: https://github.com/sponsors/knitli "Sponsor Knitli" [telemetry_impl]: <src/codeweaver/common/telemetry/> "Telemetry Implementation" [telemetry_readme]: <src/codeweaver/common/telemetry/README.md> "Telemetry README" [uv_tool]: https://astral.sh/uv "uv Package Manager" [voyage_ai]: http://voyage.ai "Voyage AI Website" [why_codeweaver]: https://docs.knitli.com/codeweaver/why/ "Why CodeWeaver" [wiki_ast]: https://en.wikipedia.org/wiki/Abstract_syntax_tree "About Abstract Syntax Trees"

Frequently asked questions

What is com.knitli/codeweaver?

Semantic code search built for AI agents. Hybrid, AST-aware, context for 166 languages.

How do I install com.knitli/codeweaver?

It runs on your machine. In Claude Code: claude mcp add codeweaver -e 'CODEWEAVER_CONFIG_FILE=<CODEWEAVER_CONFIG_FILE>' -e 'CODEWEAVER_DEBUG=false' -e 'CODEWEAVER_EMBEDDING_API_KEY=<your codeweaver_embedding_api_key>' -e 'CODEWEAVER_EMBEDDING_MODEL=voyage-code-3' -e 'CODEWEAVER_EMBEDDING_PROVIDER=voyage' -e 'CODEWEAVER_HOST=localhost' -e 'CODEWEAVER_LOG_LEVEL=WARNING' -e 'CODEWEAVER_MCP_PORT=9328' -e 'CODEWEAVER_PORT=9329' -e 'CODEWEAVER_PROFILE=<CODEWEAVER_PROFILE>' -e 'CODEWEAVER_PROJECT_NAME=<CODEWEAVER_PROJECT_NAME>' -e 'CODEWEAVER_PROJECT_PATH=<CODEWEAVER_PROJECT_PATH>' -e 'CODEWEAVER_RERANKING_API_KEY=<your codeweaver_reranking_api_key>' -e 'CODEWEAVER_RERANKING_MODEL=rerank-2.5' -e 'CODEWEAVER_RERANKING_PROVIDER=voyage' -e 'CODEWEAVER_SPARSE_EMBEDDING_MODEL=prithivida/Splade_pp_en_v1' -e 'CODEWEAVER_SPARSE_EMBEDDING_PROVIDER=fastembed' -e 'CODEWEAVER_VECTOR_STORE_API_KEY=<your codeweaver_vector_store_api_key>' -e 'CODEWEAVER_VECTOR_STORE_PORT=6333' -e 'CODEWEAVER_VECTOR_STORE_PROVIDER=qdrant' -e 'CODEWEAVER_VECTOR_STORE_URL=http://localhost' -e 'CODEWEAVER__TELEMETRY__DISABLE_TELEMETRY=false' -e 'CODEWEAVER__TELEMETRY__TOOLS_OVER_PRIVACY=false' -e 'HTTPS_PROXY=<HTTPS_PROXY>' -e 'OPENAI_API_KEY=<your openai_api_key>' -e 'OPENAI_LOG=<OPENAI_LOG>' -e 'SSL_CERT_FILE=<SSL_CERT_FILE>' -e 'AI_GATEWAY_API_KEY=<your ai_gateway_api_key>' -e 'AWS_ACCOUNT_ID=<AWS_ACCOUNT_ID>' -e 'AWS_REGION=<AWS_REGION>' -e 'AWS_SECRET_ACCESS_KEY=<your aws_secret_access_key>' -e 'AZURE_COHERE_API_KEY=<your azure_cohere_api_key>' -e 'AZURE_COHERE_ENDPOINT=<AZURE_COHERE_ENDPOINT>' -e 'AZURE_COHERE_REGION=<AZURE_COHERE_REGION>' -e 'AZURE_OPENAI_API_KEY=<your azure_openai_api_key>' -e 'AZURE_OPENAI_ENDPOINT=<AZURE_OPENAI_ENDPOINT>' -e 'AZURE_OPENAI_REGION=<AZURE_OPENAI_REGION>' -e 'COHERE_API_KEY=<COHERE_API_KEY>' -e 'CO_API_URL=<CO_API_URL>' -e 'DEEPSEEK_API_KEY=<your deepseek_api_key>' -e 'GEMINI_API_KEY=<GEMINI_API_KEY>' -e 'GOOGLE_API_KEY=<GOOGLE_API_KEY>' -e 'HF_HUB_VERBOSITY=<HF_HUB_VERBOSITY>' -e 'HF_TOKEN=<HF_TOKEN>' -e 'INFERENCE_KEY=<your inference_key>' -e 'INFERENCE_URL=<INFERENCE_URL>' -e 'MISTRAL_API_KEY=<MISTRAL_API_KEY>' -e 'QDRANT__LOG_LEVEL=<QDRANT__LOG_LEVEL>' -e 'QDRANT__SERVICE__API_KEY=<your qdrant__service__api_key>' -e 'QDRANT__SERVICE__ENABLE_TLS=<QDRANT__SERVICE__ENABLE_TLS>' -e 'QDRANT__SERVICE__HOST=<QDRANT__SERVICE__HOST>' -e 'QDRANT__SERVICE__HTTP_PORT=<QDRANT__SERVICE__HTTP_PORT>' -e 'QDRANT__TLS__CERT=<QDRANT__TLS__CERT>' -e 'TAVILY_API_KEY=<TAVILY_API_KEY>' -e 'TOGETHER_API_KEY=<your together_api_key>' -e 'VERCEL_OIDC_TOKEN=<your vercel_oidc_token>' -e 'VOYAGE_API_KEY=<your voyage_api_key>' -- uvx code-weaver==0.1.0a3 server --project '<path>' --config '<file_path>' --host '<host>' --port '<port>' --transport --verbose --debug. For other clients, paste the JSON configuration from this page into their MCP settings.

Does com.knitli/codeweaver need an API key?

Yes. It expects CODEWEAVER_EMBEDDING_API_KEY, CODEWEAVER_RERANKING_API_KEY, CODEWEAVER_VECTOR_STORE_API_KEY, OPENAI_API_KEY, AI_GATEWAY_API_KEY, AWS_SECRET_ACCESS_KEY, AZURE_COHERE_API_KEY, AZURE_OPENAI_API_KEY, DEEPSEEK_API_KEY, INFERENCE_KEY, QDRANT__SERVICE__API_KEY, TOGETHER_API_KEY, VERCEL_OIDC_TOKEN, VOYAGE_API_KEY, which you set in its configuration.

Is com.knitli/codeweaver open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains com.knitli/codeweaver?

It is published by knitli. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.