CodeWeaver Alpha 6

Name: codeweaver
Author: knitli

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

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