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.
- package/README.md +15 -13
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
# codeix
|
|
2
2
|
|
|
3
|
-
Portable, composable code index.
|
|
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
|
|
30
|
-
- **Shareable** — library authors can ship `.codeindex
|
|
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
|
|
34
|
+
- **Fast** — builds in seconds, queries in milliseconds. Rust + tree-sitter + in-memory SQLite FTS5 under the hood.
|
|
35
35
|
|
|
36
|
-
##
|
|
36
|
+
## The `.codeindex` format
|
|
37
37
|
|
|
38
|
-
|
|
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
|
-
|
|
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.
|
|
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://
|
|
10
|
+
"homepage": "https://codeix.dev",
|
|
11
11
|
"bin": {
|
|
12
12
|
"codeix": "run.js"
|
|
13
13
|
},
|