Codeweave

npm version CI License: MIT npm downloads

Make any repo instantly AI-ready via MCP — a self-hosted, zero-API-key context server for your codebase.

codeweave runs locally alongside your AI coding tool. It indexes your entire repo into a fast SQLite database and exposes it as an MCP server, giving AI assistants deep, accurate context about your code — file tree, full-text search, git history, dependencies, stack detection, and coding conventions — without ever sending your code to a third party.

---

Quick Start

# 1. Install globally (or use npx)
npm install -g codeweave

# 2. Generate a config in your project root
cd /path/to/your/project
codeweave init

# 3. Start the MCP server
codeweave start

Then add codeweave to your AI client (see AI Client Setup below).

---

Features

Feature	Description
File tree	Annotated JSON tree with language tags for every file
Full-text search	SQLite FTS5 with porter stemming — sub-millisecond queries
File content	Line-numbered file content with optional line range slicing
Git history	Recent commits with author, date, and changed files
Dependency graph	Parsed from package.json, Cargo.toml, go.mod, pyproject.toml, and 6 more
Stack detection	Automatically detects language, framework, database, test runner, styling
Convention detection	File naming style, import patterns, component structure
File watcher	Re-indexes changed files in < 1s with 300ms debounce
Incremental indexing	mtime-based cache — warm starts in < 30ms
Zero API keys	Runs entirely locally. No cloud. No telemetry.

---

AI Client Setup

codeweave uses the stdio MCP transport and works with any MCP-compatible client.

Claude Code

Add to .claude/settings.json in your project root:

{
  "mcpServers": {
    "codeweave": {
      "command": "npx",
      "args": ["codeweave"],
      "cwd": "."
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "codeweave": {
      "command": "npx",
      "args": ["codeweave"],
      "cwd": "${workspaceFolder}"
    }
  }
}

Zed

Add to ~/.config/zed/settings.json:

{
  "context_servers": {
    "codeweave": {
      "command": {
        "path": "npx",
        "args": ["codeweave"]
      }
    }
  }
}

Continue.dev

Add to .continue/config.json:

{
  "mcpServers": [
    {
      "name": "codeweave",
      "command": "npx",
      "args": ["codeweave"]
    }
  ]
}

---

CLI Reference

codeweave [command] [options]

Commands:
  start    Start the MCP server (default)
  init     Generate codeweave.config.js in the current directory
  status   Show indexing stats for the current repo

Options:
  --verbose    Enable debug logging
  -V, --version  Show version number
  -h, --help     Show help

See the full CLI reference →

---

Configuration

Run codeweave init to generate a codeweave.config.js. All fields are optional — defaults work well for most projects.

// codeweave.config.js
export default {
  // Directories to index (relative to config file)
  include: ['src'],

  // Extra patterns to exclude beyond .gitignore
  exclude: ['**/*.generated.ts'],

  // Files larger than this are truncated (KB)
  maxFileSizeKB: 100,

  // How many git commits to read
  gitDepth: 50,

  // Port for future HTTP transport
  port: 3333,

  // Enable verbose/debug logging
  verbose: false,
};

See the full configuration reference →

---

MCP Tools

codeweave exposes 7 MCP tools that AI assistants can call:

Tool	Description
get_file_tree	Annotated file tree, filterable by language
get_file	File content with line numbers and optional line range
search_codebase	Full-text search with snippet context
get_conventions	Detected naming style, import patterns, test framework
get_dependencies	All dependencies from parsed manifest files
get_git_history	Recent commits, filterable by file path
get_stack_info	Detected language, framework, database, tooling

See the full API reference →

---

Architecture

your repo on disk
      │
      ▼
┌─────────────────────────────────────────────────────┐
│                   codeweave process                  │
│                                                     │
│  ┌──────────┐  ┌──────────┐  ┌───────────────────┐ │
│  │ File     │  │   Git    │  │  Manifest Parser  │ │
│  │ Scanner  │  │  Reader  │  │  (9 formats)      │ │
│  └────┬─────┘  └────┬─────┘  └────────┬──────────┘ │
│       │              │                 │            │
│       └──────────────┴─────────────────┘            │
│                       │                             │
│              ┌────────▼────────┐                   │
│              │  SQLite DB      │                   │
│              │  (WAL + FTS5)   │◄──────────────────┤
│              └────────┬────────┘     File Watcher  │
│                       │                             │
│       ┌───────────────┼───────────────┐            │
│       ▼               ▼               ▼            │
│  get_file_tree   search_codebase  get_stack_info   │
│  get_file        get_conventions  get_dependencies │
│  get_git_history                                   │
│       │                                            │
│       └──────────────────────────────────────────┐ │
│                    MCP Server (stdio)             │ │
└───────────────────────────────────────────────────┘
                        │
              ┌─────────┘
              ▼
    AI client (Claude Code, Cursor, Zed…)

Key design decisions:

• SQLite over in-memory — the full file content lives on disk, not in the Node.js heap. Memory usage stays flat regardless of repo size.
• FTS5 porter tokenizer — full-text search that handles stemming (authenticate → authenticat) without any external dependencies.
• mtime cache — unchanged files are never re-read. Warm starts on a 1K-file repo take ~28ms.
• Stdio transport — no port conflicts, no firewall rules. Works in any environment where the AI client can spawn a subprocess.

---

Supported Stacks

codeweave detects and parses:

Languages: TypeScript, JavaScript, Python, Go, Rust, Dart, Ruby, PHP, Java, Kotlin, Swift, and more

Frameworks: Next.js, Nuxt, Remix, SvelteKit, Astro, Vite+React, Express, Fastify, NestJS, Hono, Django, Flask, FastAPI, Rails, Laravel, Symfony, Angular, Vue, Svelte

Databases: Prisma, TypeORM, Drizzle, MongoDB, PostgreSQL, MySQL, SQLite, Redis, Sequelize

Manifest formats: package.json, pubspec.yaml, Cargo.toml, go.mod, requirements.txt, pyproject.toml, composer.json, Gemfile, build.gradle

---

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for guidelines on how to fork, develop, test, and submit PRs.

git clone https://github.com/MdAbdullahAlMahmud/codeweave.git
cd codeweave
npm install
npm test         # run tests
npm run typecheck  # type check
npm run lint     # lint

---

License

MIT © Abdullah — see LICENSE for details.