codeix 0.1.8 → 0.3.0

package/README.md

@@ -5,7 +5,7 @@
 ```
 codeix                 # start MCP server, watch for changes
 codeix build           # parse source files, write .codeindex
-codeix serve --no-watch  # serve without file watching
+codeix -r ~/project build  # build from a specific directory
 ```
 
 ## Why
@@ -30,7 +30,7 @@ AI coding agents spend most of their token budget *finding* code before they can
 - **Shareable** — library authors can ship `.codeindex` in their npm/PyPI/crates.io package. Consumers get instant navigation of dependencies.
 - **Composable** — the MCP server auto-discovers dependency indexes and mounts them. Query your code and your dependencies in one place.
 - **Structured for LLMs** — symbols have kinds, signatures, parent relationships, and line ranges. The agent gets exactly what it needs in one tool call instead of piecing it together from raw text.
-- **Prose search** — `search_texts` targets comments, docstrings, and string literals specifically. Find TODOs, find the error message a user reported, find what a function's docstring says — without noise from code.
+- **Prose search** — `search --scope text` targets comments, docstrings, and string literals specifically. Find TODOs, find the error message a user reported, find what a function's docstring says — without noise from code.
 - **Fast** — builds in seconds, queries in milliseconds. Rust + tree-sitter + in-memory SQLite FTS5 under the hood.
 
 ## The `.codeindex` format
@@ -63,16 +63,18 @@ Works with Git repos, npm, PyPI, and crates.io.
 
 ## MCP tools
 
-Six tools, zero setup. The agent queries immediately — no init, no config, no refresh.
+Eight tools, zero setup. The agent queries immediately — no init, no config, no refresh.
 
 | Tool | What it does |
 |---|---|
-| `search_symbols` | Fuzzy search across all symbols (FTS5, BM25-ranked) |
-| `search_files` | Find files by name, path, or language |
-| `search_texts` | Full-text search on comments, docstrings, strings |
+| `explore` | Explore project structure: metadata, subprojects, files grouped by directory |
+| `search` | Unified full-text search across symbols, files, and texts (FTS5, BM25-ranked) with scope/kind/path/project filters |
 | `get_file_symbols` | List all symbols in a file |
-| `get_symbol_children` | Get children of a class/module |
+| `get_children` | Get children of a class/module |
 | `get_imports` | List imports for a file |
+| `get_callers` | Find all places that call or reference a symbol |
+| `get_callees` | Find all symbols that a function/method calls |
+| `flush_index` | Flush pending index changes to disk |
 
 ## Project discovery
 
@@ -96,6 +98,13 @@ Tree-sitter grammars, feature-gated at compile time:
 | C++ | `lang-cpp` | yes | `.cpp` `.cc` `.cxx` `.hpp` `.hxx` |
 | Ruby | `lang-ruby` | yes | `.rb` `.rake` `.gemspec` |
 | C# | `lang-csharp` | yes | `.cs` |
+| Markdown | `lang-markdown` | yes | `.md` `.markdown` |
+
+### Markdown support
+
+Markdown files are parsed for **headings** (both ATX `#` and Setext underline styles) which are indexed as `section` symbols with hierarchical parent-child relationships — enabling TOC extraction and document structure navigation.
+
+Fenced code blocks are extracted as `code` text entries, parented to their containing section.
 
 ### Embedded scripts
 
@@ -140,7 +149,7 @@ All channels install the same single binary. No runtime dependencies.
 codeix build
 
 # Build from a specific directory (discovers all git repos below)
-codeix build ~/projects
+codeix -r ~/projects build
 
 # Start MCP server (default command, watches for changes)
 codeix
@@ -148,6 +157,9 @@ codeix
 # Or explicitly
 codeix serve
 codeix serve --no-watch
+
+# Serve from a specific directory
+codeix -r ~/projects serve
 ```
 
 ### MCP client configuration
@@ -169,7 +181,7 @@ Add to your MCP client config (e.g. Claude Desktop, Cursor):
 - **Local only** — no network, no API keys, works offline and air-gapped
 - **Deterministic** — same source always produces the same index (clean diffs)
 - **Composable** — dependency indexes are auto-discovered and mounted at query time
-- **Minimal surface** — 6 query tools, zero management plumbing
+- **Minimal surface** — 7 query tools, zero management plumbing
 
 ## Architecture
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeix",
-  "version": "0.1.8",
+  "version": "0.3.0",
   "description": "Portable, composable code index — build with tree-sitter, query via MCP",
   "license": "MIT OR Apache-2.0",
   "repository": {