local-codebase-indexer 0.2.0__tar.gz → 0.3.0__tar.gz

local_codebase_indexer-0.3.0/AGENTS.md

@@ -0,0 +1,48 @@
+# Instructions for AI coding assistants
+
+This repository is **local-codebase-indexer**: a local code index (SQLite, no cloud) that you can use as an MCP server or CLI to find code, callers, and SQL table/stored-procedure access with far fewer tokens than reading files.
+
+## Install (pick one)
+
+```bash
+pip install local-codebase-indexer                      # from PyPI (Python 3.10+)
+pipx install local-codebase-indexer                     # isolated
+pip install "git+https://github.com/sfy257000/local-codebase-indexer.git"   # latest from GitHub
+```
+
+Check: `local-codebase-indexer --help`. No API keys or network access are needed after installation.
+
+## Use it on a project
+
+```bash
+local-codebase-indexer --root <project> index                      # build / refresh the index
+local-codebase-indexer --root <project> search "natural language or identifier" --limit 5
+local-codebase-indexer --root <project> relations <SymbolName> --direction both
+local-codebase-indexer --root <project> data-access <TableOrProcedure>   # who reads / writes / executes it
+local-codebase-indexer --root <project> context <file> --lines 120 --padding 15
+local-codebase-indexer --root <project> status                     # is the index fresh?
+```
+
+Put `--json` before the subcommand for JSON output. The index lives in `<project>/.ai_context/` (git-ignored automatically).
+
+## Register as an MCP server (Claude Code)
+
+```bash
+claude mcp add local-indexer -- local-codebase-indexer --root <project> serve
+```
+
+Tools: `codebase_semantic_search`, `codebase_get_symbol_relations`, `codebase_get_optimized_context`, `codebase_get_data_access`, `codebase_index_status`.
+
+## Reading the results
+
+- Relations and data-access entries carry a confidence: `confirmed`, `probable`, `candidate` / `uncertain`. Treat `candidate` and `uncertain` (dynamic SQL) as leads to verify in the source, not facts.
+- If `status` reports `stale`, run `index`.
+
+## Working on this repo itself
+
+```bash
+pip install -e ".[dev,onnx]" && python -m pytest -q
+python benchmarks/run_benchmark.py --compare benchmarks/baseline.json
+```
+
+The package is `local_codebase_indexer/`. See `README.md` for design notes and known limits, `TODO.md` for planned work.

local_codebase_indexer-0.3.0/CLAUDE.md

@@ -0,0 +1,48 @@
+# Instructions for AI coding assistants
+
+This repository is **local-codebase-indexer**: a local code index (SQLite, no cloud) that you can use as an MCP server or CLI to find code, callers, and SQL table/stored-procedure access with far fewer tokens than reading files.
+
+## Install (pick one)
+
+```bash
+pip install local-codebase-indexer                      # from PyPI (Python 3.10+)
+pipx install local-codebase-indexer                     # isolated
+pip install "git+https://github.com/sfy257000/local-codebase-indexer.git"   # latest from GitHub
+```
+
+Check: `local-codebase-indexer --help`. No API keys or network access are needed after installation.
+
+## Use it on a project
+
+```bash
+local-codebase-indexer --root <project> index                      # build / refresh the index
+local-codebase-indexer --root <project> search "natural language or identifier" --limit 5
+local-codebase-indexer --root <project> relations <SymbolName> --direction both
+local-codebase-indexer --root <project> data-access <TableOrProcedure>   # who reads / writes / executes it
+local-codebase-indexer --root <project> context <file> --lines 120 --padding 15
+local-codebase-indexer --root <project> status                     # is the index fresh?
+```
+
+Put `--json` before the subcommand for JSON output. The index lives in `<project>/.ai_context/` (git-ignored automatically).
+
+## Register as an MCP server (Claude Code)
+
+```bash
+claude mcp add local-indexer -- local-codebase-indexer --root <project> serve
+```
+
+Tools: `codebase_semantic_search`, `codebase_get_symbol_relations`, `codebase_get_optimized_context`, `codebase_get_data_access`, `codebase_index_status`.
+
+## Reading the results
+
+- Relations and data-access entries carry a confidence: `confirmed`, `probable`, `candidate` / `uncertain`. Treat `candidate` and `uncertain` (dynamic SQL) as leads to verify in the source, not facts.
+- If `status` reports `stale`, run `index`.
+
+## Working on this repo itself
+
+```bash
+pip install -e ".[dev,onnx]" && python -m pytest -q
+python benchmarks/run_benchmark.py --compare benchmarks/baseline.json
+```
+
+The package is `local_codebase_indexer/`. See `README.md` for design notes and known limits, `TODO.md` for planned work.

local_codebase_indexer-0.3.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include server.json README*.md TODO.md AGENTS.md CLAUDE.md llms.txt index.md requirements.txt
+graft tests
+graft benchmarks
+prune benchmarks/__pycache__
+global-exclude __pycache__ *.pyc

{local_codebase_indexer-0.2.0/local_codebase_indexer.egg-info → local_codebase_indexer-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: local-codebase-indexer
-Version: 0.2.0
+Version: 0.3.0
 Summary: Local codebase indexer and context provider for AI coding assistants: MCP server and CLI with SQL data-access and C# call relations. No cloud, no server.
 Author: sfy257000
 Project-URL: Homepage, https://github.com/sfy257000/local-codebase-indexer
@@ -50,6 +50,10 @@ pipx install local-codebase-indexer
 
 From a clone: `pip install -e .` (the `bin/indexer` launcher still works in a checkout).
 
+## For AI assistants
+
+If you are an AI coding assistant asked to set this up: run `pip install local-codebase-indexer`, then `claude mcp add local-indexer -- local-codebase-indexer --root <project> serve` (Claude Code) or use the CLI commands below. Full instructions are in [`AGENTS.md`](AGENTS.md).
+
 ## Usage (CLI)
 
 ```bash
@@ -116,3 +120,5 @@ Queries are expanded with a small synonym dictionary (`SP` / `預存程序` / `s
 ```bash
 python -m pytest -q
 ```
+
+<!-- mcp-name: io.github.sfy257000/local-codebase-indexer -->

{local_codebase_indexer-0.2.0 → local_codebase_indexer-0.3.0}/README.md

@@ -15,6 +15,10 @@ pipx install local-codebase-indexer
 
 From a clone: `pip install -e .` (the `bin/indexer` launcher still works in a checkout).
 
+## For AI assistants
+
+If you are an AI coding assistant asked to set this up: run `pip install local-codebase-indexer`, then `claude mcp add local-indexer -- local-codebase-indexer --root <project> serve` (Claude Code) or use the CLI commands below. Full instructions are in [`AGENTS.md`](AGENTS.md).
+
 ## Usage (CLI)
 
 ```bash
@@ -81,3 +85,5 @@ Queries are expanded with a small synonym dictionary (`SP` / `預存程序` / `s
 ```bash
 python -m pytest -q
 ```
+
+<!-- mcp-name: io.github.sfy257000/local-codebase-indexer -->

local_codebase_indexer-0.3.0/llms.txt

@@ -0,0 +1,10 @@
+# local-codebase-indexer
+
+> Local codebase indexer and context provider for AI coding assistants. MCP server and CLI, SQLite storage, no cloud. Understands C#, Python, JS/TS and T-SQL, including which code reads or writes a table or stored procedure.
+
+Install: `pip install local-codebase-indexer`, then `local-codebase-indexer --root <project> index`.
+
+- [AGENTS.md](AGENTS.md): install, commands, MCP registration, how to read confidence levels
+- [README.md](README.md): features, design, known limits
+- [TODO.md](TODO.md): planned work
+- [benchmarks/README.md](benchmarks/README.md): how search quality is measured

{local_codebase_indexer-0.2.0 → local_codebase_indexer-0.3.0}/local_codebase_indexer/__init__.py

@@ -1,3 +1,3 @@
 """Universal Local Codebase Indexer & Context Provider (see index.md)."""
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"

{local_codebase_indexer-0.2.0 → local_codebase_indexer-0.3.0/local_codebase_indexer.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: local-codebase-indexer
-Version: 0.2.0
+Version: 0.3.0
 Summary: Local codebase indexer and context provider for AI coding assistants: MCP server and CLI with SQL data-access and C# call relations. No cloud, no server.
 Author: sfy257000
 Project-URL: Homepage, https://github.com/sfy257000/local-codebase-indexer
@@ -50,6 +50,10 @@ pipx install local-codebase-indexer
 
 From a clone: `pip install -e .` (the `bin/indexer` launcher still works in a checkout).
 
+## For AI assistants
+
+If you are an AI coding assistant asked to set this up: run `pip install local-codebase-indexer`, then `claude mcp add local-indexer -- local-codebase-indexer --root <project> serve` (Claude Code) or use the CLI commands below. Full instructions are in [`AGENTS.md`](AGENTS.md).
+
 ## Usage (CLI)
 
 ```bash
@@ -116,3 +120,5 @@ Queries are expanded with a small synonym dictionary (`SP` / `預存程序` / `s
 ```bash
 python -m pytest -q
 ```
+
+<!-- mcp-name: io.github.sfy257000/local-codebase-indexer -->

{local_codebase_indexer-0.2.0 → local_codebase_indexer-0.3.0}/local_codebase_indexer.egg-info/SOURCES.txt

@@ -1,11 +1,15 @@
+AGENTS.md
+CLAUDE.md
 MANIFEST.in
 README.md
 README.zh-CN.md
 README.zh-TW.md
 TODO.md
 index.md
+llms.txt
 pyproject.toml
 requirements.txt
+server.json
 benchmarks/README.md
 benchmarks/baseline.json
 benchmarks/queries_stdlib.json

local_codebase_indexer-0.3.0/server.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.sfy257000/local-codebase-indexer",
+  "title": "Local Codebase Indexer",
+  "description": "Local code index for AI assistants: search, call relations and SQL table/procedure access.",
+  "repository": {
+    "url": "https://github.com/sfy257000/local-codebase-indexer",
+    "source": "github"
+  },
+  "version": "0.3.0",
+  "packages": [
+    {
+      "registryType": "pypi",
+      "identifier": "local-codebase-indexer",
+      "version": "0.3.0",
+      "runtimeHint": "uvx",
+      "transport": {
+        "type": "stdio"
+      },
+      "packageArguments": [
+        {
+          "type": "named",
+          "name": "--root",
+          "description": "Absolute path of the project folder to index",
+          "isRequired": true,
+          "format": "string"
+        },
+        {
+          "type": "positional",
+          "value": "serve"
+        }
+      ]
+    }
+  ]
+}

local_codebase_indexer-0.2.0/MANIFEST.in

@@ -1,5 +0,0 @@
-include README*.md TODO.md index.md requirements.txt
-graft tests
-graft benchmarks
-prune benchmarks/__pycache__
-global-exclude __pycache__ *.pyc