codeweaver

Name: codeweaver
Author: knitli

ArchivedIncomplete39/100Claim

pypi code-weaverstdioApache-2.0updated 2mo ago

SPDX-License-Identifier: MIT OR Apache-2.0 -->

This repository was archived by its owner. It still works, but it is not receiving updates.

Source Website Docs12

What can you do with codeweaver?

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

Install

Add codeweaver to your client. Pick the one you use.

claude mcp add code-weaver -- uvx code-weaver

codex mcp add code-weaver -- uvx code-weaver

amp mcp add code-weaver -- uvx code-weaver

{
  "mcpServers": {
    "code-weaver": {
      "command": "uvx",
      "args": [
        "code-weaver"
      ]
    }
  }
}

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "code-weaver": {
      "command": "uvx",
      "args": [
        "code-weaver"
      ]
    }
  }
}

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

code --add-mcp '{"name":"code-weaver","command":"uvx","args":["code-weaver"]}'

Or add the block manually to `.vscode/mcp.json` under `servers`.

{
  "mcpServers": {
    "code-weaver": {
      "command": "uvx",
      "args": [
        "code-weaver"
      ]
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.

{
  "mcpServers": {
    "code-weaver": {
      "command": "uvx",
      "args": [
        "code-weaver"
      ]
    }
  }
}

Add to `cline_mcp_settings.json` via the MCP Servers panel.

{
  "mcpServers": {
    "code-weaver": {
      "command": "uvx",
      "args": [
        "code-weaver"
      ]
    }
  }
}

Add to `~/.gemini/settings.json`.

{
  "mcpServers": {
    "code-weaver": {
      "type": "local",
      "command": "uvx",
      "args": [
        "code-weaver"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.

{
  "context_servers": {
    "code-weaver": {
      "command": {
        "path": "uvx",
        "args": [
          "code-weaver"
        ]
      }
    }
  }
}

Add to your Zed `settings.json`.

uvx code-weaver

Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.