---

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

📊 See detailed competitive analysis →

---

🚀 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 →

---