{
  "markdown": "<!--\nSPDX-FileCopyrightText: 2025 Knitli Inc.\nSPDX-FileContributor: Adam Poulemanos <adam@knit.li>\n\nSPDX-License-Identifier: MIT OR Apache-2.0\n-->\n\n> [!WARNING]\n> \n> ## CodeWeaver is no longer maintained\n>\n> We're really proud of CodeWeaver and think it's pretty awesome, but we can't maintain it anymore.\n>\n> We're focused on [something else](https://marque.tools).\n> \n> CodeWeaver is (was?) a sophisticated, smart, code search tool with wide provider support.\n> and it's still licensed under your choice of MIT or Apache-2.0.\n> \n> So please, **fork it and build something great!**\n\n<div align=\"center\">\n\n<picture>\n  <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/knitli/codeweaver/refs/heads/main/docs-site/src/assets/codeweaver-reverse.svg\">\n  <source media=\"(prefers-color-scheme: light)\" srcset=\"https://raw.githubusercontent.com/knitli/codeweaver/refs/heads/main/docs-site/src/assets/codeweaver-primary.svg\">\n  <img alt=\"CodeWeaver logo\" src=\"https://raw.githubusercontent.com/knitli/codeweaver/refs/heads/main/docs-site/src/assets/codeweaver-primary.svg\" height=\"150px\" width=\"150px\">\n</picture>\n\n# CodeWeaver\n\n### Exquisite Context for Agents — Infrastructure that is Extensible, Predictable, and Resilient.\n\n[![Python Version][badge_python]][link_python]\n[![License][badge_license]][link_license]\n[![Release][badge_release]][link_release]\n[![MCP Compatible][badge_mcp]][link_mcp]\n[![codecov](https://codecov.io/github/knitli/codeweaver/graph/badge.svg?token=EO3DQVHVVH)](https://codecov.io/github/knitli/codeweaver)\n\n[Documentation][nav_docs] •\n[Installation][nav_install] •\n[Features][nav_features] •\n[Comparison][nav_comparison]\n\n</div>\n\n---\n\n## What It Does\n\n**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.\n\nCodeWeaver 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.\n\n**Example:**\n```\nWithout CodeWeaver:\n  Claude: \"Let me search for 'auth'... here are 50 files mentioning authentication\"\n  Result: Generic code, wrong context, wasted tokens\n\nWith CodeWeaver:\n  You: \"Where do we validate OAuth tokens?\"\n  Claude gets: The exact 3 functions across 2 files, with surrounding context\n  Result: Precise answers, focused context, 60-80% token reduction\n```\n\n> CodeWeaver is no longer in alpha!\n> \n> **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][issues].\n\n---\n\n## How CodeWeaver Stacks Up\n\n### Quick Reference Matrix\n\n| Feature | CodeWeaver | Legacy Search Tools |\n| :--- | :--- | :--- |\n| **Search Type** | Hybrid (Semantic + AST + Keyword) | Keyword Only |\n| **Context Quality** | **Exquisite** / High-Precision | Noisy / Irrelevant |\n| **Extensibility** | **DI-Driven** (Zero-Code Provider Swap) | Hardcoded |\n| **Reliability** | **Resilient** (Automatic Local Fallback) | Fails on API Timeout |\n| **Token Usage** | **Optimized** (60–80% Reduction) | Wasted on Noise |\n\n---\n\n## 🚀 Getting Started\n\n### Quick Install\n\nUsing the [CLI](#cli) with [uv][uv_tool]:\n```bash\n# Add CodeWeaver to your project\nuv add code-weaver\n\n# Initialize with a profile (recommended uses Voyage AI)\ncw init --profile recommended\n\n# Verify setup\ncw doctor\n\n# Start the background daemon\ncw start\n```\n\n> **📝 Note**: `cw init` supports different **Profiles**:\n> - `recommended`: High-precision search (Voyage AI + Qdrant)\n> - `quickstart`: 100% local, private, and free (FastEmbed + Local Qdrant)\n>\n> **Want full offline?** See the [Local-Only Guide][local_only_guide].\n\n🐳 **Prefer Docker?** [See Docker setup guide →][docker_guide]\n\n---\n\n## ✨ Features\n\n<table>\n<tr>\n<td width=\"50%\">\n\n### 🔍 Exquisite Context\n- **Hybrid search** (sparse + dense vectors)\n- **AST-level understanding** (27 languages)\n- **Reciprocal Rank Fusion (RRF)**\n- **Language-aware chunking** (166+ languages)\n\n</td>\n<td width=\"50%\">\n\n### 🛡️ Industrial Resilience\n- **Automatic local fallback** (FastEmbed)\n- **Circuit breaker pattern** for APIs\n- **Works airgapped** (no cloud required)\n- **Pydantic-driven validation** at boot-time\n\n</td>\n</tr>\n<tr>\n<td>\n\n### 🧩 Universal Extensibility\n- **100% DI-driven architecture**\n- **17+ integrated providers**\n- **Custom provider API**\n- **Zero-code provider swapping**\n\n</td>\n<td>\n\n### 🛠️ Developer Experience\n- **Live indexing** with file watching\n- **Diagnostic tool** (`cw doctor`)\n- **Multiple CLI aliases** (`cw` / `codeweaver`)\n- **Selectable profiles** for easy setup\n\n</td>\n</tr>\n</table>\n\n---\n\n## 💭 Philosophy: Context is Oxygen\n\nAI 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.**\n\n- **Curation over Collection:** Give agents exactly what they need, nothing more.\n- **Privacy-First:** Your code stays local if you want it to.\n- **Infrastructure over Tooling:** Built to be the reliable foundation for your AI stack.\n\n📖 [Read the detailed rationale →][why_codeweaver]\n\n---\n<div align=\"center\">\n\n**Official Documentation: [docs.knitli.com/codeweaver/](https://docs.knitli.com/codeweaver/)**\n\n**Built with ❤️ by [Knitli][knitli_site]**\n\n[⬆ Back to top][nav_top]\n\n</div>\n\n<!-- Badges -->\n\n[badge_license]: <https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-green.svg> \"License Badge\"\n[badge_mcp]: <https://img.shields.io/badge/MCP-compatible-purple.svg> \"MCP Compatible Badge\"\n[badge_python]: <https://img.shields.io/badge/python-3.12%2B-blue.svg> \"Python Version Badge\"\n[badge_release]: <https://img.shields.io/pypi/v/code-weaver.svg> \"PyPI Version\"\n\n<!-- Other links -->\n\n[api_find_code]: <src/codeweaver/agent_api/find_code/README.md> \"find_code API Documentation\"\n[arch_find_code]: <src/codeweaver/agent_api/find_code/ARCHITECTURE.md> \"find_code Architecture\"\n[bashandbone]: <https://github.com/bashandbone> \"Adam Poulemanos' GitHub Profile\"\n[codecov]: <https://codecov.io/gh/knitli/codeweaver/graph/badge.svg?token=EO3DQVHVVH> \"Code Coverage\"\n[changelog]: <https://github.com/knitli/codeweaver/blob/main/CHANGELOG.md> \"Changelog\"\n[cla]: <CONTRIBUTORS_LICENSE_AGREEMENT.md> \"Contributor License Agreement\"\n[cli_guide]: <docs/CLI.md> \"Command Line Reference\"\n[config_schema]: <schema/codeweaver.schema.json> \"The CodeWeaver Config Schema\"\n[docker_guide]: <https://docs.knitli.com/codeweaver/guides/docker/> \"Docker Setup Guide\"\n[docker_notes]: <docs/docker/DOCKER_BUILD_NOTES.md> \"Docker Build Notes\"\n[enhancement_label]: <https://github.com/knitli/codeweaver/labels/enhancement> \"Enhancement Issues\"\n[issues]: <https://github.com/knitli/codeweaver/issues> \"Report an Issue\"\n[knitli_blog]: <https://blog.knitli.com> \"Knitli Blog\"\n[knitli_github]: <https://github.com/knitli> \"Knitli GitHub Organization\"\n[knitli_linkedin]: <https://linkedin.com/company/knitli> \"Knitli LinkedIn\"\n[knitli_site]: <https://knitli.com> \"Knitli Website\"\n[knitli_x]: <https://x.com/knitli_inc> \"Knitli X/Twitter\"\n[link_license]: <LICENSE> \"License File\"\n[link_mcp]: <https://modelcontextprotocol.io> \"Model Context Protocol Website\"\n[link_python]: <https://www.python.org/downloads/> \"Python Downloads\"\n[link_release]: <https://github.com/knitli/codeweaver/releases> \"CodeWeaver Releases\"\n[mcp]: <https://modelcontextprotocol.io> \"Learn About the Model Context Protocol\"\n[local_only_guide]: <https://docs.knitli.com/codeweaver/guides/local-only/> \"Local-Only Operation Guide\"\n[nav_contributing]: <#-contributing> \"Contributing Section\"\n[nav_docs]: <https://docs.knitli.com/codeweaver/> \"CodeWeaver Documentation\"\n[nav_comparison]: <#-quick_reference_matrix> \"How CodeWeaver Compares\"\n[nav_features]: <#-features> \"Features Section\"\n[nav_how_it_works]: <#-how-it-works> \"How It Works Section\"\n[nav_install]: <#-getting-started> \"Installation Section\"\n[nav_top]: <#codeweaver> \"Back to Top\"\n[privacy_policy]: <PRIVACY_POLICY.md> \"Privacy Policy\"\n[providers_list]: <overrides/partials/providers.md> \"Full Provider List\"\n[qdrant]: <https://qdrant.tech> \"Qdrant Website\"\n[repo]: <https://github.com/knitli/codeweaver> \"CodeWeaver Repository\"\n[reuse_spec]: <https://reuse.software> \"REUSE Specification\"\n[sbom]: <sbom.spdx> \"Software Bill of Materials\"\n[sponsor]: <https://github.com/sponsors/knitli> \"Sponsor Knitli\"\n[telemetry_impl]: <src/codeweaver/common/telemetry/> \"Telemetry Implementation\"\n[telemetry_readme]: <src/codeweaver/common/telemetry/README.md> \"Telemetry README\"\n[uv_tool]: <https://astral.sh/uv> \"uv Package Manager\"\n[voyage_ai]: <http://voyage.ai> \"Voyage AI Website\"\n[why_codeweaver]: <https://docs.knitli.com/codeweaver/why/> \"Why CodeWeaver\"\n[wiki_ast]: <https://en.wikipedia.org/wiki/Abstract_syntax_tree> \"About Abstract Syntax Trees\"\n",
  "bytes": 9039,
  "sha": "f4f59607cf822ac2a1739a2526ad7cd562d5bcc831e10062fa73b7bc99ba4cf8",
  "repo_slug": "knitli/codeweaver",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_knitli_codeweaver_488f2e0b/readme"
}