How do I install Codeweaver?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Codeweaver need an API key?

The publisher lists these environment variables: CODEWEAVER_CONFIG_FILE, CODEWEAVER_DEBUG, CODEWEAVER_EMBEDDING_API_KEY, CODEWEAVER_EMBEDDING_MODEL, CODEWEAVER_EMBEDDING_PROVIDER, CODEWEAVER_HOST, CODEWEAVER_LOG_LEVEL, CODEWEAVER_MCP_PORT, CODEWEAVER_PORT, CODEWEAVER_PROFILE, CODEWEAVER_PROJECT_NAME, CODEWEAVER_PROJECT_PATH, CODEWEAVER_RERANKING_API_KEY, CODEWEAVER_RERANKING_MODEL, CODEWEAVER_RERANKING_PROVIDER, CODEWEAVER_SPARSE_EMBEDDING_MODEL, CODEWEAVER_SPARSE_EMBEDDING_PROVIDER, CODEWEAVER_VECTOR_STORE_API_KEY, CODEWEAVER_VECTOR_STORE_PORT, CODEWEAVER_VECTOR_STORE_PROVIDER, CODEWEAVER_VECTOR_STORE_URL, CODEWEAVER__TELEMETRY__DISABLE_TELEMETRY, CODEWEAVER__TELEMETRY__TOOLS_OVER_PRIVACY, HTTPS_PROXY, OPENAI_API_KEY, OPENAI_LOG, SSL_CERT_FILE, AI_GATEWAY_API_KEY, AWS_ACCOUNT_ID, AWS_REGION, AWS_SECRET_ACCESS_KEY, AZURE_COHERE_API_KEY, AZURE_COHERE_ENDPOINT, AZURE_COHERE_REGION, AZURE_OPENAI_API_KEY, AZURE_OPENAI_ENDPOINT, AZURE_OPENAI_REGION, COHERE_API_KEY, CO_API_URL, DEEPSEEK_API_KEY, GEMINI_API_KEY, GOOGLE_API_KEY, HF_HUB_VERBOSITY, HF_TOKEN, INFERENCE_KEY, INFERENCE_URL, MISTRAL_API_KEY, QDRANT__LOG_LEVEL, QDRANT__SERVICE__API_KEY, QDRANT__SERVICE__ENABLE_TLS, QDRANT__SERVICE__HOST, QDRANT__SERVICE__HTTP_PORT, QDRANT__TLS__CERT, TAVILY_API_KEY, TOGETHER_API_KEY, VERCEL_OIDC_TOKEN, VOYAGE_API_KEY.

What transport does Codeweaver use?

Codeweaver runs locally over stdio.

When was Codeweaver last checked?

Last checked 2026-11-08. Semantic code search built for AI agents. Hybrid, AST-aware, context for 166 languages.

Codeweaver MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

uvx code-weaver==0.1.0a3

Credentials from the publisher

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 — 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 — 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 — 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 — 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 — 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 — AWS Secret Access Key for Bedrock service
AZURE_COHERE_API_KEY — 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 — 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 — 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 — API key for Heroku service
INFERENCE_URL — Host URL for Heroku service
MISTRAL_API_KEY — Your Mistral API Key
OPENAI_API_KEY — 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 — 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 — API key for Together service
VERCEL_OIDC_TOKEN — OIDC token for Vercel service
VOYAGE_API_KEY — API key for Voyage service

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1CODEWEAVER_CONFIG_FILE=<value> CODEWEAVER_DEBUG=<value> CODEWEAVER_EMBEDDING_API_KEY=<secret> CODEWEAVER_EMBEDDING_MODEL=<value> CODEWEAVER_EMBEDDING_PROVIDER=<value> CODEWEAVER_HOST=<value> CODEWEAVER_LOG_LEVEL=<value> CODEWEAVER_MCP_PORT=<value> CODEWEAVER_PORT=<value> CODEWEAVER_PROFILE=<value> CODEWEAVER_PROJECT_NAME=<value> CODEWEAVER_PROJECT_PATH=<value> CODEWEAVER_RERANKING_API_KEY=<secret> CODEWEAVER_RERANKING_MODEL=<value> CODEWEAVER_RERANKING_PROVIDER=<value> CODEWEAVER_SPARSE_EMBEDDING_MODEL=<value> CODEWEAVER_SPARSE_EMBEDDING_PROVIDER=<value> CODEWEAVER_VECTOR_STORE_API_KEY=<secret> CODEWEAVER_VECTOR_STORE_PORT=<value> CODEWEAVER_VECTOR_STORE_PROVIDER=<value> CODEWEAVER_VECTOR_STORE_URL=<value> CODEWEAVER__TELEMETRY__DISABLE_TELEMETRY=<value> CODEWEAVER__TELEMETRY__TOOLS_OVER_PRIVACY=<value> HTTPS_PROXY=<value> OPENAI_API_KEY=<secret> OPENAI_LOG=<value> SSL_CERT_FILE=<value> AI_GATEWAY_API_KEY=<secret> AWS_ACCOUNT_ID=<value> AWS_REGION=<value> AWS_SECRET_ACCESS_KEY=<secret> AZURE_COHERE_API_KEY=<secret> AZURE_COHERE_ENDPOINT=<value> AZURE_COHERE_REGION=<value> AZURE_OPENAI_API_KEY=<secret> AZURE_OPENAI_ENDPOINT=<value> AZURE_OPENAI_REGION=<value> COHERE_API_KEY=<value> CO_API_URL=<value> DEEPSEEK_API_KEY=<secret> GEMINI_API_KEY=<value> GOOGLE_API_KEY=<value> HF_HUB_VERBOSITY=<value> HF_TOKEN=<value> INFERENCE_KEY=<secret> INFERENCE_URL=<value> MISTRAL_API_KEY=<value> QDRANT__LOG_LEVEL=<value> QDRANT__SERVICE__API_KEY=<secret> QDRANT__SERVICE__ENABLE_TLS=<value> QDRANT__SERVICE__HOST=<value> QDRANT__SERVICE__HTTP_PORT=<value> QDRANT__TLS__CERT=<value> TAVILY_API_KEY=<value> TOGETHER_API_KEY=<secret> VERCEL_OIDC_TOKEN=<secret> VOYAGE_API_KEY=<secret> claude mcp add com.knitli-codeweaver -- uvx code-weaver==0.1.0a3

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.knitli-codeweaver": {4      "command": "uvx",5      "args": [6        "code-weaver==0.1.0a3"7      ],8      "env": {9        "CODEWEAVER_CONFIG_FILE": "<value>",10        "CODEWEAVER_DEBUG": "<value>",11        "CODEWEAVER_EMBEDDING_API_KEY": "<secret>",12        "CODEWEAVER_EMBEDDING_MODEL": "<value>",13        "CODEWEAVER_EMBEDDING_PROVIDER": "<value>",14        "CODEWEAVER_HOST": "<value>",15        "CODEWEAVER_LOG_LEVEL": "<value>",16        "CODEWEAVER_MCP_PORT": "<value>",17        "CODEWEAVER_PORT": "<value>",18        "CODEWEAVER_PROFILE": "<value>",19        "CODEWEAVER_PROJECT_NAME": "<value>",20        "CODEWEAVER_PROJECT_PATH": "<value>",21        "CODEWEAVER_RERANKING_API_KEY": "<secret>",22        "CODEWEAVER_RERANKING_MODEL": "<value>",23        "CODEWEAVER_RERANKING_PROVIDER": "<value>",24        "CODEWEAVER_SPARSE_EMBEDDING_MODEL": "<value>",25        "CODEWEAVER_SPARSE_EMBEDDING_PROVIDER": "<value>",26        "CODEWEAVER_VECTOR_STORE_API_KEY": "<secret>",27        "CODEWEAVER_VECTOR_STORE_PORT": "<value>",28        "CODEWEAVER_VECTOR_STORE_PROVIDER": "<value>",29        "CODEWEAVER_VECTOR_STORE_URL": "<value>",30        "CODEWEAVER__TELEMETRY__DISABLE_TELEMETRY": "<value>",31        "CODEWEAVER__TELEMETRY__TOOLS_OVER_PRIVACY": "<value>",32        "HTTPS_PROXY": "<value>",33        "OPENAI_API_KEY": "<secret>",34        "OPENAI_LOG": "<value>",35        "SSL_CERT_FILE": "<value>",36        "AI_GATEWAY_API_KEY": "<secret>",37        "AWS_ACCOUNT_ID": "<value>",38        "AWS_REGION": "<value>",39        "AWS_SECRET_ACCESS_KEY": "<secret>",40        "AZURE_COHERE_API_KEY": "<secret>",41        "AZURE_COHERE_ENDPOINT": "<value>",42        "AZURE_COHERE_REGION": "<value>",43        "AZURE_OPENAI_API_KEY": "<secret>",44        "AZURE_OPENAI_ENDPOINT": "<value>",45        "AZURE_OPENAI_REGION": "<value>",46        "COHERE_API_KEY": "<value>",47        "CO_API_URL": "<value>",48        "DEEPSEEK_API_KEY": "<secret>",49        "GEMINI_API_KEY": "<value>",50        "GOOGLE_API_KEY": "<value>",51        "HF_HUB_VERBOSITY": "<value>",52        "HF_TOKEN": "<value>",53        "INFERENCE_KEY": "<secret>",54        "INFERENCE_URL": "<value>",55        "MISTRAL_API_KEY": "<value>",56        "QDRANT__LOG_LEVEL": "<value>",57        "QDRANT__SERVICE__API_KEY": "<secret>",58        "QDRANT__SERVICE__ENABLE_TLS": "<value>",59        "QDRANT__SERVICE__HOST": "<value>",60        "QDRANT__SERVICE__HTTP_PORT": "<value>",61        "QDRANT__TLS__CERT": "<value>",62        "TAVILY_API_KEY": "<value>",63        "TOGETHER_API_KEY": "<secret>",64        "VERCEL_OIDC_TOKEN": "<secret>",65        "VOYAGE_API_KEY": "<secret>"66      }67    }68  }69}

claude_desktop_config.json

Local · pypiPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

[!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.

Documentation • Installation • Features • 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.

How CodeWeaver Stacks Up

Quick Reference Matrix

Feature	CodeWeaver	Legacy Search Tools
Search Type	Hybrid (Semantic + AST + Keyword)	Keyword Only
Context Quality	Exquisite / High-Precision	Noisy / Irrelevant
Extensibility	DI-Driven (Zero-Code Provider Swap)	Hardcoded
Reliability	Resilient (Automatic Local Fallback)	Fails on API Timeout
Token Usage	Optimized (60–80% Reduction)	Wasted on Noise

🚀 Getting Started

Quick Install

Using the CLI with uv:

# 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.

🐳 Prefer Docker? See Docker setup 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 →

Official Documentation: docs.knitli.com/codeweaver/

Built with ❤️ by Knitli

⬆ Back to top