codesearch-mcp 0.0.17-alpha → 0.0.17-alpha.1

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 +10 -26
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # codesearch-mcp
2
2
 
3
- Semantic codebase search for Claude. Indexes your local projects into a PostgreSQL vector database and exposes search via the Model Context Protocol (MCP).
3
+ Semantic codebase search for AI agents. Indexes your local projects into a PostgreSQL vector database and exposes search via the Model Context Protocol (MCP).
4
4
 
5
- Ask Claude things like *"where is the payment retry logic?"* or *"show me how auth tokens are validated"* — across all your projects at once.
5
+ Ask your AI agent things like *"where is the payment retry logic?"* or *"show me how auth tokens are validated"* — across all your projects at once.
6
6
 
7
7
  > **Alpha** — works well locally, API may change before 1.0.
8
8
 
@@ -107,25 +107,6 @@ Pass `include_graph_context: true` to `search_codebase` to see direct imports an
107
107
 
108
108
  Useful for immediately understanding a file's role in the dependency graph.
109
109
 
110
- ## Cross-encoder reranking
111
-
112
- By default, results are ordered by cosine distance (vector similarity). Enable cross-encoder reranking to reorder candidates by semantic relevance — better for queries where the exact wording differs from how the code is written.
113
-
114
- Requires Ollama ≥ 0.6 and a reranker model:
115
-
116
- ```bash
117
- ollama pull qllama/bge-reranker-v2-m3
118
- ```
119
-
120
- ```bash
121
- rag-config set reranker.enabled true
122
- rag-config set reranker.model qllama/bge-reranker-v2-m3
123
- # rag-config set reranker.url http://localhost:11434/api/rerank # default
124
- # rag-config set reranker.overfetch 3 # fetch limit×3 candidates before reranking
125
- ```
126
-
127
- When enabled, `search_codebase` fetches `limit × reranker.overfetch` vector candidates, then the cross-encoder reranks them and returns the top `limit`. Falls back gracefully to vector order if the reranker is unreachable.
128
-
129
110
  ## Excluding files
130
111
 
131
112
  Create `.ragignore` in a project root — same syntax as `.gitignore`:
@@ -154,7 +135,14 @@ rag-config set logging.dir false
154
135
 
155
136
  ## Configuration
156
137
 
157
- All set by `rag-setup`. Override individual keys with `rag-config set <key> <value>`. Stored in `~/.config/codesearch-mcp/config.json`.
138
+ All set by `rag-setup`. Stored in `~/.config/codesearch-mcp/config.json`.
139
+
140
+ ```bash
141
+ rag-config show # print current config (password redacted)
142
+ rag-config get <key> # print a single value
143
+ rag-config set <key> <value> # update a value
144
+ rag-config reset <key> # remove key (reverts to default)
145
+ ```
158
146
 
159
147
  | Key | Default | Description |
160
148
  |-----|---------|-------------|
@@ -170,10 +158,6 @@ All set by `rag-setup`. Override individual keys with `rag-config set <key> <val
170
158
  | `search.autoTranslate` | `false` | Translate non-English queries to English before embedding |
171
159
  | `search.translateModel` | `llama3.2` | Ollama model for translation (requires `ollama pull llama3.2`) |
172
160
  | `indexing.astBatchSize` | `3000` | Max files per ts-morph batch — lower if indexing large projects causes OOM |
173
- | `reranker.enabled` | `false` | Enable cross-encoder reranking (requires Ollama ≥ 0.6 and `reranker.model`) |
174
- | `reranker.model` | — | Reranker model name (e.g. `qllama/bge-reranker-v2-m3`) |
175
- | `reranker.url` | `${ollama.host}/api/rerank` | Override rerank endpoint URL |
176
- | `reranker.overfetch` | `3` | Candidate multiplier before reranking (`limit × N`, max 20) |
177
161
  | `logging.level` | `error` | Log level written to file: `error` \| `warn` \| `info` \| `debug` |
178
162
  | `logging.dir` | `~/.config/codesearch-mcp/logs` | Base log directory, or `"false"` to disable |
179
163
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "codesearch-mcp",
3
- "version": "0.0.17-alpha",
3
+ "version": "0.0.17-alpha.1",
4
4
  "description": "Local semantic codebase search via MCP — indexes projects into pgvector, exposes search to Claude",
5
5
  "license": "MIT",
6
6
  "main": "dist/app.js",