rekipedia 0.11.1 → 0.13.0

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 +42 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -120,8 +120,19 @@ llm:
120
120
  export REKIPEDIA_MODEL=gpt-5.5
121
121
  export REKIPEDIA_API_KEY=sk-...
122
122
  export REKIPEDIA_BASE_URL=https://my-proxy/v1
123
+ export REKIPEDIA_SHARD_TOKEN_BUDGET=40000
123
124
  ```
124
125
 
126
+ | Variable | Description |
127
+ |---|---|
128
+ | `REKIPEDIA_MODEL` | LLM model name to use |
129
+ | `REKIPEDIA_API_KEY` | API key for the LLM provider |
130
+ | `REKIPEDIA_BASE_URL` | Base URL for OpenAI-compatible endpoints |
131
+ | `REKIPEDIA_SHARD_TOKEN_BUDGET` | Max tokens per shard group (default: 40000) |
132
+ | `REKIPEDIA_AGENT_ASK` | Set to `1` to enable agentic ReAct ask loop (default: `0` — single-shot) |
133
+ | `REKIPEDIA_ASK_MAX_ITER` | Max tool-call iterations for agentic ask (default: `5`) |
134
+ | `REKIPEDIA_AGENT_PLANNER` | Set to `1` to enable tool-calling wiki planner (default: `0`) |
135
+
125
136
  ---
126
137
 
127
138
  ## Output
@@ -287,6 +298,37 @@ rekipedia ships a **Hermes agent skill** (`rekipedia-agent-skill.md`) that teach
287
298
 
288
299
  ---
289
300
 
301
+ ## Agentic Mode
302
+
303
+ rekipedia supports an experimental agentic mode where LLM calls use tool-calling (ReAct) instead of single large context dumps.
304
+
305
+ ### Agentic Ask
306
+
307
+ Set `REKIPEDIA_AGENT_ASK=1` to enable:
308
+
309
+ ```bash
310
+ REKIPEDIA_AGENT_ASK=1 reki ask "How does authentication work?"
311
+ ```
312
+
313
+ The LLM issues tool calls to retrieve information on demand:
314
+ - `search_code(query)` — semantic search over source code
315
+ - `get_symbol(name)` — look up symbol location and signature
316
+ - `get_page(slug)` — fetch a wiki page on demand
317
+ - `get_relationships(target)` — dependency graph for a symbol/file
318
+ - `finish(answer)` — provide final answer
319
+
320
+ Max iterations can be configured with `REKIPEDIA_ASK_MAX_ITER` (default: 5).
321
+
322
+ ### Agentic Planner
323
+
324
+ Set `REKIPEDIA_AGENT_PLANNER=1` to enable tool-calling wiki structure planning:
325
+
326
+ ```bash
327
+ REKIPEDIA_AGENT_PLANNER=1 reki scan .
328
+ ```
329
+
330
+ The planner builds the wiki structure incrementally using tool calls instead of generating a single large JSON response.
331
+
290
332
  ## Development
291
333
 
292
334
  ```bash
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "rekipedia",
3
- "version": "0.11.1",
3
+ "version": "0.13.0",
4
4
  "description": "Agentic repo-to-wiki: scan any repository into a portable SQLite knowledge store with wiki pages, diagrams, and grounded Q&A.",
5
5
  "bin": {
6
6
  "rekipedia": "./bin/rekipedia.js"