--- title: Roadmap | CodeWeaver Docs description: CodeWeaver is a code search engine for AI agents, designed to provide precise results that give agents exactly what they need for their tasks -- no more, no less. url: "https://docs.knitli.com/concepts/roadmap" type: static generatedAt: "2026-04-17T17:21:09.942Z" --- # Roadmap [Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fconcepts%2Froadmap%2F.%20I%20want%20to%20ask%20questions%20about%20it.)[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fconcepts%2Froadmap%2F.%20I%20want%20to%20ask%20questions%20about%20it.)[View in Markdown](/codeweaver/concepts/roadmap.md) [Share on LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fconcepts%2Froadmap%2F)[Share on X](https://x.com/intent/tweet?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fconcepts%2Froadmap%2F&text=Roadmap)[Share on Threads](https://threads.net/intent/post?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fconcepts%2Froadmap%2F&text=Roadmap)[Share on Bluesky](https://bsky.app/intent/compose?text=Roadmap%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fconcepts%2Froadmap%2F)[Share on Facebook](https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fconcepts%2Froadmap%2F)[Share on Reddit](https://reddit.com/submit?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fconcepts%2Froadmap%2F&title=Roadmap)[Share on Hacker News](https://news.ycombinator.com/submitlink?u=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fconcepts%2Froadmap%2F&t=Roadmap)[Share on Email](mailto:?subject=Roadmap&body=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fconcepts%2Froadmap%2F)[Share on WhatsApp](https://wa.me/?text=Roadmap%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fconcepts%2Froadmap%2F)[Share on Telegram](https://t.me/share/url?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fconcepts%2Froadmap%2F&text=Roadmap) # Roadmap [Section titled “Roadmap”](#roadmap) > **TL;DR:** This page outlines where CodeWeaver is heading. It saves you from surprises by providing transparency on upcoming changes and the path to 1.0. CodeWeaver has completed a major infrastructure overhaul. With the Dependency Injection (DI) system and configuration rewrite complete, we are now preparing for the next milestones: **the Monorepo Split** and **Context Agent integration**. --- ## Pre-1.0 Stability Contract [Section titled “Pre-1.0 Stability Contract”](#pre-10-stability-contract) CodeWeaver is currently in the **0.1.x series**, the first semi-stable foundation after the alpha line. Until we reach 1.0, version numbers follow a pre-1.0 SemVer convention: - **Patch releases (0.1.x):** Bug fixes and non-breaking improvements. Always safe to upgrade within a minor series. - **Minor releases (0.x.0):** New features and architectural improvements. **May include breaking changes** — we will document migration steps in the [changelog](/codeweaver/changelog/), but config formats, public Python APIs, and CLI flags can shift between minor versions until 1.0. - **1.0.0:** API stability guarantees kick in. Once we ship 1.0, we will follow strict SemVer. If you’re integrating CodeWeaver into something that depends on stable interfaces, **pin the minor version** (e.g. `code-weaver>=0.1,<0.2`) and read the changelog before bumping. The jump from `0.1.0-alpha.5` → `0.1.0` was a hard reset: nearly every public surface changed. The alpha line is no longer supported and should not be used as a reference for current behavior. --- ## Current Status: 0.1.2-dev (Pre-1.0 Foundation) [Section titled “Current Status: 0.1.2-dev (Pre-1.0 Foundation)”](#current-status-012-dev-pre-10-foundation) The 0.1.x series represents **Industrial-Grade Context**. We have replaced fragmented registries with a unified, FastAPI-inspired DI system. CodeWeaver is no longer just a “search tool” — it is a professional infrastructure component for AI agents. **Key Achievements:** - **100% DI Integration:** Every service is now registered and injected via the `@dependency_provider` system. - **Config Validation:** Pydantic-driven settings catch errors before they reach your agents. - **Resilient Pipeline:** Automatic local fallbacks ensure 100% context availability. --- ## Next: 0.2.0 (Extensibility) [Section titled “Next: 0.2.0 (Extensibility)”](#next-020-extensibility) The primary goal of 0.2.0 is the **Monorepo Split**. We are reorganizing the codebase into independent, selectively installable packages. Expect breaking changes to import paths and `pyproject.toml` extras. ### 1. Package Separation [Section titled “1. Package Separation”](#1-package-separation) Currently, CodeWeaver is a single large package. In 0.2.0, it will be split into: - `codeweaver-core`: The base infrastructure, DI container, and logging. - `codeweaver-providers`: Embedding, vector store, and agent integrations. - `codeweaver-engine`: The indexing and search logic. - `codeweaver-server`: The MCP and Management server components. ### 2. Selective Installation [Section titled “2. Selective Installation”](#2-selective-installation) The monorepo structure allows you to install only what you need. If you are building a custom search engine, you might only install `core` and `engine`. If you only need MCP connectivity, you might only install `core` and `server`. ### 3. Legacy Cleanup [Section titled “3. Legacy Cleanup”](#3-legacy-cleanup) 0.2.0 completes the architectural cleanup. We are removing the last remnants of legacy registries and hardcoded imports, ensuring that each package is truly independent and “monorepo-safe.” --- ## The Path to 1.0 [Section titled “The Path to 1.0”](#the-path-to-10) Our long-term goal is to establish CodeWeaver as the **Universal Context Layer** for AI. - **0.3.0:** Context Agent integration and agentic pipeline orchestration. - **0.4.0:** Enhanced cloud orchestration and distributed indexing. - **1.0.0:** API stability guarantees, performance-at-scale, and production hardening. We are building CodeWeaver in the open, and we welcome feedback from the community as we move toward a stable 1.0 release.