indexer-cli 0.12.14 → 0.12.15
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
CHANGED
|
@@ -7,7 +7,7 @@ right code.
|
|
|
7
7
|
|
|
8
8
|
The main feature of `indexer-cli` is not just search on its own: it turns your repository into something coding agents
|
|
9
9
|
can navigate efficiently. Running `idx init` installs a project-local discovery skill so Claude, OpenCode, and similar
|
|
10
|
-
tools can pick the right indexed workflow instead of wasting tokens on blind `grep`, `find`, and repeated file reads.
|
|
10
|
+
tools can pick the right indexed workflow instead of wasting tokens on blind `rg`/`grep`, `find`, and repeated file reads.
|
|
11
11
|
|
|
12
12
|
Under the hood, `indexer-cli` indexes source code, generates vector embeddings through a local Ollama instance, and
|
|
13
13
|
stores everything in a per-project `.indexer-cli/` directory. That gives both humans and agents fast natural-language
|
|
@@ -79,7 +79,7 @@ before they start burning tokens on broad filesystem scans.
|
|
|
79
79
|
|
|
80
80
|
## Why agents save tokens with this
|
|
81
81
|
|
|
82
|
-
Without repo-local skills, agents often spend tokens on repetitive repository discovery: broad `grep`, repeated file
|
|
82
|
+
Without repo-local skills, agents often spend tokens on repetitive repository discovery: broad `rg`/`grep`, repeated file
|
|
83
83
|
reads, and trial-and-error navigation. With `indexer-cli`, agents can load one focused discovery skill and start from
|
|
84
84
|
the right indexed path immediately.
|
|
85
85
|
|
|
@@ -107,7 +107,7 @@ idx architecture
|
|
|
107
107
|
All discovery commands return human-readable text output, optimized for coding agents.
|
|
108
108
|
|
|
109
109
|
This is especially useful in Claude and OpenCode setups, where project-local skills can guide the agent away from
|
|
110
|
-
blind `grep`/`find` usage and toward indexed discovery, which usually means less wasted context and lower token usage
|
|
110
|
+
blind `rg`/`grep`/`find` usage and toward indexed discovery, which usually means less wasted context and lower token usage
|
|
111
111
|
during repo discovery.
|
|
112
112
|
|
|
113
113
|
## CLI Commands
|
|
@@ -7,8 +7,8 @@ exports.GENERATED_SKILLS = [
|
|
|
7
7
|
directory: "repo-discovery",
|
|
8
8
|
content: `---
|
|
9
9
|
name: repo-discovery
|
|
10
|
-
description: FIRST choice for repository discovery and code understanding. Use this to choose the cheapest indexed path for architecture, structure, behavior, symbol, AST, or dependency questions before broad file reads or
|
|
11
|
-
allowed-tools: Bash(idx architecture:*), Bash(idx structure:*), Bash(idx ast:*), Bash(idx search:*), Bash(idx explain:*), Bash(idx deps:*)
|
|
10
|
+
description: FIRST choice for repository discovery and code understanding. Use this to choose the cheapest indexed path for architecture, structure, behavior, symbol, AST, or dependency questions before broad file reads or blind text search.
|
|
11
|
+
allowed-tools: Bash(idx architecture:*), Bash(idx structure:*), Bash(idx ast:*), Bash(idx search:*), Bash(idx explain:*), Bash(idx deps:*), Bash(rg:*), Bash(grep:*)
|
|
12
12
|
---
|
|
13
13
|
|
|
14
14
|
# Use repo-discovery as the indexed entry point
|
|
@@ -43,17 +43,17 @@ Pick the single cheapest command that answers the question, run it, and stop whe
|
|
|
43
43
|
- Do **not** run \`idx explain\` as a prelude to reading a file you already know you need.
|
|
44
44
|
- Do **not** chain discovery steps mechanically (\`search → explain\`, \`explain → Read\`) when direct reading is cheaper.
|
|
45
45
|
|
|
46
|
-
## Use idx vs
|
|
46
|
+
## Use idx vs exact text search/LSP
|
|
47
47
|
|
|
48
48
|
idx is **semantic** search: use it when you do **not** know the exact name and need to find code by meaning.
|
|
49
49
|
|
|
50
|
-
Use
|
|
51
|
-
- exact identifier name → \`grep\`, \`lsp_symbols\`, or references/definition tools
|
|
50
|
+
Use exact text search/LSP when the target is already concrete:
|
|
51
|
+
- exact identifier name → \`rg\` (preferred), \`grep\`, \`lsp_symbols\`, or references/definition tools
|
|
52
52
|
- exact small file path → \`Read\`
|
|
53
53
|
- exact large file path + unknown internal layout → \`idx ast <file>\`, then read the smallest ranges
|
|
54
54
|
- known file + known symbol → \`idx explain file::symbol\` or LSP if exact lookup is enough
|
|
55
55
|
|
|
56
|
-
Rule of thumb: if you can write an exact search pattern, use \`
|
|
56
|
+
Rule of thumb: avoid broad blind \`rg\`/\`grep\`/\`find\` during discovery, but if you can write an exact search pattern, use \`rg\`/LSP. Use idx for exploration, not lookup.
|
|
57
57
|
|
|
58
58
|
## Query guidance
|
|
59
59
|
|
|
@@ -99,7 +99,7 @@ idx deps src/api/client.ts --show-edges
|
|
|
99
99
|
idx search "MyType" --path-prefix src/models/
|
|
100
100
|
|
|
101
101
|
# Better: exact lookup is cheaper
|
|
102
|
-
|
|
102
|
+
rg -n "MyType" src/models/
|
|
103
103
|
\`\`\`
|
|
104
104
|
|
|
105
105
|
## Skip idx when
|
|
@@ -1 +1 @@
|
|
|
1
|
-
export declare const SKILLS_VERSION =
|
|
1
|
+
export declare const SKILLS_VERSION = 631682001;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"skills-version.js","sourceRoot":"","sources":["../../src/core/skills-version.ts"],"names":[],"mappings":";;;AAAa,QAAA,cAAc,GAAG,
|
|
1
|
+
{"version":3,"file":"skills-version.js","sourceRoot":"","sources":["../../src/core/skills-version.ts"],"names":[],"mappings":";;;AAAa,QAAA,cAAc,GAAG,SAAS,CAAC"}
|