com.knitli/codeweaver
Semantic code search built for AI agents. Hybrid, AST-aware, context for 166 languages.
CodeWeaver Alpha 6
Exquisite Context for Agents — Infrastructure that is Extensible, Predictable, and Resilient.
Documentation • Installation • Features • Comparison
</div>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 Alpha 6 transforms from a "Search Tool" into 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⚠️ Alpha Release: CodeWeaver is in active development. Use it, break it, help shape it.
How CodeWeaver Stacks Up
Quick Reference Matrix
| Feature | CodeWeaver Alpha 6 | 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
# 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 initsupports 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
<table> <tr> <td width="50%">🔍 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 →
<div align="center">
Official Documentation: docs.knitli.com/codeweaver/
Built with ❤️ by Knitli
</div>