From f7ff79118866d3198cdcc6a9c59881344bd00a4a Mon Sep 17 00:00:00 2001
From: Clawd <ai@clawd.bot>
Date: Thu, 5 Mar 2026 07:05:24 -0800
Subject: Initial design doc

---
 README.md | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..aba79e3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+# codevec
+
+Semantic code search via embeddings.
+
+```bash
+codevec index .
+codevec query "websocket connection handling"
+```
+
+## Status
+
+**Design phase** — see [DESIGN.md](DESIGN.md)
+
+## Overview
+
+Index your codebase, query by concept. Get relevant code chunks with file paths and line numbers.
+
+- AST-aware chunking (tree-sitter) for Go, TypeScript, Python
+- sqlite-vec for fast similarity search
+- Incremental updates (only re-index changed files)
+- Integrates with claude-flow as a `CodeSearch` tool
+
+## Why
+
+`grep` finds keywords. `codevec` finds meaning.
+
+```bash
+# grep misses this
+grep "authentication"  # won't find verifyJWT()
+
+# codevec finds it
+codevec query "authentication"
+# src/auth.go:15-42 VerifyJWT (0.89)
+```
-- 
cgit v1.2.3