rekipedia 0.12.0 → 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 +34 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -129,6 +129,9 @@ export REKIPEDIA_SHARD_TOKEN_BUDGET=40000
129
129
  | `REKIPEDIA_API_KEY` | API key for the LLM provider |
130
130
  | `REKIPEDIA_BASE_URL` | Base URL for OpenAI-compatible endpoints |
131
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`) |
132
135
 
133
136
  ---
134
137
 
@@ -295,6 +298,37 @@ rekipedia ships a **Hermes agent skill** (`rekipedia-agent-skill.md`) that teach
295
298
 
296
299
  ---
297
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
+
298
332
  ## Development
299
333
 
300
334
  ```bash
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "rekipedia",
3
- "version": "0.12.0",
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"