codeix 0.1.7 → 0.1.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +15 -13
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,10 +1,10 @@
1
1
  # codeix
2
2
 
3
- Portable, composable code index. Build once with tree-sitter, query anywhere via MCP.
3
+ **[codeix.dev](https://codeix.dev)** · Portable, composable code index. Your AI agent finds the right function on the first try — no scanning, no guessing, no wasted tokens.
4
4
 
5
5
  ```
6
6
  codeix # start MCP server, watch for changes
7
- codeix build # parse source files, write .codeindex/
7
+ codeix build # parse source files, write .codeindex
8
8
  codeix serve --no-watch # serve without file watching
9
9
  ```
10
10
 
@@ -26,20 +26,16 @@ AI coding agents spend most of their token budget *finding* code before they can
26
26
 
27
27
  ### What codeix does differently
28
28
 
29
- - **Committed to git** — the index is a `.codeindex/` directory you commit with your code. Clone the repo, the index is already there. No re-indexing.
30
- - **Shareable** — library authors can ship `.codeindex/` in their npm/PyPI/crates.io package. Consumers get instant navigation of dependencies.
29
+ - **Committed to git** — the index is a `.codeindex` directory you commit with your code. Clone the repo, the index is already there. No re-indexing.
30
+ - **Shareable** — library authors can ship `.codeindex` in their npm/PyPI/crates.io package. Consumers get instant navigation of dependencies.
31
31
  - **Composable** — the MCP server auto-discovers dependency indexes and mounts them. Query your code and your dependencies in one place.
32
32
  - **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.
33
33
  - **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.
34
- - **Fast** — Rust + tree-sitter + in-memory SQLite FTS5. Builds in seconds, queries in milliseconds.
34
+ - **Fast** — builds in seconds, queries in milliseconds. Rust + tree-sitter + in-memory SQLite FTS5 under the hood.
35
35
 
36
- ## What it does
36
+ ## The `.codeindex` format
37
37
 
38
- Codeix scans your source code with [tree-sitter](https://tree-sitter.github.io/), extracts symbols, imports, comments, and docstrings, then writes a `.codeindex/` directory you commit alongside your code.
39
-
40
- AI agents query it through [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) to navigate codebases without re-parsing anything.
41
-
42
- ## The index format
38
+ An open, portable format for structured code indexing. Plain JSONL files you commit alongside your code git-friendly diffs, human-readable with `grep` and `jq`, no binary blobs.
43
39
 
44
40
  ```
45
41
  .codeindex/
@@ -49,7 +45,7 @@ AI agents query it through [MCP](https://modelcontextprotocol.io/) (Model Contex
49
45
  texts.jsonl # one line per comment, docstring, string literal
50
46
  ```
51
47
 
52
- Plain JSONL. Git-friendly diffs. Human-readable with `grep` and `jq`. No binary blobs.
48
+ Any tool that can parse JSON can consume a `.codeindex`. Codeix builds it using [tree-sitter](https://tree-sitter.github.io/), and AI agents query it through [MCP](https://modelcontextprotocol.io/) (Model Context Protocol).
53
49
 
54
50
  **Example** — `symbols.jsonl`:
55
51
  ```jsonl
@@ -59,6 +55,12 @@ Plain JSONL. Git-friendly diffs. Human-readable with `grep` and `jq`. No binary
59
55
  {"file":"src/main.py","name":"main","kind":"function","line":[48,60],"sig":"def main(args: list[str]) -> int"}
60
56
  ```
61
57
 
58
+ ## Ship your index with your package
59
+
60
+ Include `.codeindex` in your package and every developer who depends on you gets instant navigation of your API — no setup, no re-indexing.
61
+
62
+ Works with Git repos, npm, PyPI, and crates.io.
63
+
62
64
  ## MCP tools
63
65
 
64
66
  Six tools, zero setup. The agent queries immediately — no init, no config, no refresh.
@@ -74,7 +76,7 @@ Six tools, zero setup. The agent queries immediately — no init, no config, no
74
76
 
75
77
  ## Project discovery
76
78
 
77
- Launch `codeix` from any directory. It walks downward and treats every directory containing `.git/` as a separate project — each gets its own `.codeindex/`.
79
+ Launch `codeix` from any directory. It walks downward and treats every directory containing `.git/` as a separate project — each gets its own `.codeindex`.
78
80
 
79
81
  Works uniformly for single repos, monorepos, sibling repos, and git submodules. No config needed.
80
82
 
package/package.json CHANGED
@@ -1,13 +1,13 @@
1
1
  {
2
2
  "name": "codeix",
3
- "version": "0.1.7",
3
+ "version": "0.1.8",
4
4
  "description": "Portable, composable code index — build with tree-sitter, query via MCP",
5
5
  "license": "MIT OR Apache-2.0",
6
6
  "repository": {
7
7
  "type": "git",
8
8
  "url": "git+https://github.com/montanetech/codeix.git"
9
9
  },
10
- "homepage": "https://github.com/montanetech/codeix",
10
+ "homepage": "https://codeix.dev",
11
11
  "bin": {
12
12
  "codeix": "run.js"
13
13
  },