docs: add README for npm packages

Author: pnftrading

packages/adapter-typescript/README.md

@@ -0,0 +1,33 @@
+# @codeindex/adapter-typescript
+
+**TypeScript/JavaScript language adapter for codeindex** — Uses ts-morph for full AST parsing.
+
+## Features
+
+- Full TypeScript and JavaScript support
+- JSX/TSX support
+- Interface, type alias, enum extraction
+- Generic type parameter support
+- Doc comment extraction
+
+## Supported Extensions
+
+- `.ts` — TypeScript files
+- `.tsx` — TypeScript JSX files
+- `.js` — JavaScript files
+- `.jsx` — JavaScript JSX files
+
+## Usage
+
+```typescript
+import { TypeScriptAdapter } from "@codeindex/adapter-typescript"
+
+const adapter = new TypeScriptAdapter()
+
+const parsed = await adapter.parseFile("src/auth/service.ts", "/project")
+// Returns: { filePath, language: "typescript", symbols, imports, exports }
+```
+
+## License
+
+MIT — See [main repo](https://github.com/zorrong/codeindex)

packages/cli/README.md

@@ -0,0 +1,60 @@
+# @codeindex/cli
+
+**Vectorless, reasoning-based code index for AI context retrieval.**
+
+> Cut your AI coding costs by 95%. `codeindex` gives AI exactly the context it needs — nothing more.
+
+## Quick Start
+
+```bash
+# Install
+npm install -g @codeindex/cli
+
+# Setup (one-time)
+codeindex setup
+
+# Index your project
+cd your-project
+codeindex index .
+
+# Query!
+codeindex query "How does authentication work?"
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `codeindex setup` | Global configuration (API Key, Provider) |
+| `codeindex init [path]` | Initialize project |
+| `codeindex index [path]` | Build/rebuild index |
+| `codeindex query "<text>"` | Query the index |
+| `codeindex update [path]` | Incremental update |
+| `codeindex status [path]` | Check index health |
+| `codeindex serve [path]` | HTTP server for IDE integration |
+
+## Features
+
+- **Token Efficient** — ~2KB response instead of 50KB+
+- **Vectorless** — Uses LLM reasoning, not embeddings
+- **Multi-Language** — TypeScript, Python, Go, Rust, Java, C#, C++, PHP, Swift
+- **IDE Integration** — HTTP API for VSCode, JetBrains, Neovim, Claude Code
+
+## IDE Integration
+
+### Claude Code
+```bash
+curl -s -X POST http://localhost:3131/query \
+  -d '{"query": "$1", "maxTokens": 3000}' | jq -r '.context'
+```
+
+### Cursor / Windsurf
+Add to `.cursorrules`:
+```
+When you need context, run:
+  curl -s -X POST http://localhost:3131/query -d '{"query": "YOUR_QUESTION"}'
+```
+
+## License
+
+MIT — See [main repo](https://github.com/zorrong/codeindex)

packages/core/README.md

@@ -0,0 +1,45 @@
+# @codeindex/core
+
+**Core engine for codeindex** — Tree index, retrieval logic, and interfaces.
+
+## What is this?
+
+The core package provides:
+- **TreeBuilder** — Build hierarchical index from parsed files
+- **TreeTraversal** — LLM-powered traversal to find relevant context
+- **FileScanner** — File discovery with gitignore support
+- **LanguageAdapter interface** — Standard interface for language parsers
+
+## Usage
+
+```typescript
+import { IndexManager, TreeTraversal } from "@codeindex/core"
+
+const manager = new IndexManager({
+  projectRoot: "/path/to/project",
+  llmClient,
+  adapters: [typescriptAdapter]
+})
+
+await manager.build()
+const result = await traversal.traverse("How does auth work?")
+```
+
+## For Package Authors
+
+To add support for a new language, implement the `LanguageAdapter` interface:
+
+```typescript
+interface LanguageAdapter {
+  readonly language: SupportedLanguage
+  readonly fileExtensions: string[]
+
+  supports(filePath: string): boolean
+  parseFile(filePath: string, projectRoot: string): Promise<ParsedFile>
+  resolveImport(importPath: string, fromFile: string, projectRoot: string): Promise<string | null>
+}
+```
+
+## License
+
+MIT — See [main repo](https://github.com/zorrong/codeindex)