agent-knowledge 1.8.1 → 1.9.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.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "agent-knowledge",
3
3
  "description": "Cross-session memory for AI coding agents. Git-synced Markdown knowledge base with hybrid semantic + TF-IDF search, typed knowledge graph, and session auto-distillation with secrets scrubbing.",
4
- "version": "1.8.1",
4
+ "version": "1.9.0",
5
5
  "author": {
6
6
  "name": "keshrath"
7
7
  },
package/CHANGELOG.md CHANGED
@@ -1,5 +1,42 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.9.0 (2026-04-18) — env var naming cleanup (**breaking**)
4
+
5
+ Every env var is now under the canonical `AGENT_KNOWLEDGE_*` prefix per the repo-wide Genericity rule (`AGENT_<NAME>_<RESOURCE>`). The old `KNOWLEDGE_*` prefix and the unscoped `EXTRA_SESSION_ROOTS` are gone — no deprecation shim, no startup warning, just renamed. README and docs table rewritten so no host name (`Claude Code`, `~/.claude`) leaks into descriptions — the adapter registry already auto-detects `.claude`, `.cursor`, `.codex`, `.aider`, `.continue`, and OpenCode without configuration.
6
+
7
+ ### Breaking changes
8
+
9
+ All renames are mechanical — rename the env var, nothing else:
10
+
11
+ | Old | New |
12
+ | ---------------------------------- | ---------------------------------------- |
13
+ | `KNOWLEDGE_MEMORY_DIR` | `AGENT_KNOWLEDGE_MEMORY_DIR` |
14
+ | `KNOWLEDGE_DATA_DIR` | `AGENT_KNOWLEDGE_DATA_DIR` |
15
+ | `KNOWLEDGE_GIT_URL` | `AGENT_KNOWLEDGE_GIT_URL` |
16
+ | `KNOWLEDGE_AUTO_DISTILL` | `AGENT_KNOWLEDGE_AUTO_DISTILL` |
17
+ | `KNOWLEDGE_INDEX_VERBATIM` | `AGENT_KNOWLEDGE_INDEX_VERBATIM` |
18
+ | `KNOWLEDGE_PORT` | `AGENT_KNOWLEDGE_PORT` |
19
+ | `KNOWLEDGE_EMBEDDING_PROVIDER` | `AGENT_KNOWLEDGE_EMBEDDING_PROVIDER` |
20
+ | `KNOWLEDGE_EMBEDDING_ALPHA` | `AGENT_KNOWLEDGE_EMBEDDING_ALPHA` |
21
+ | `KNOWLEDGE_EMBEDDING_MODEL` | `AGENT_KNOWLEDGE_EMBEDDING_MODEL` |
22
+ | `KNOWLEDGE_EMBEDDING_IDLE_TIMEOUT` | `AGENT_KNOWLEDGE_EMBEDDING_IDLE_TIMEOUT` |
23
+ | `KNOWLEDGE_EMBEDDING_THREADS` | `AGENT_KNOWLEDGE_EMBEDDING_THREADS` |
24
+ | `KNOWLEDGE_OPENAI_API_KEY` | `AGENT_KNOWLEDGE_OPENAI_API_KEY` |
25
+ | `KNOWLEDGE_ANTHROPIC_API_KEY` | `AGENT_KNOWLEDGE_ANTHROPIC_API_KEY` |
26
+ | `KNOWLEDGE_GEMINI_API_KEY` | `AGENT_KNOWLEDGE_GEMINI_API_KEY` |
27
+ | `EXTRA_SESSION_ROOTS` | `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` |
28
+
29
+ Standard third-party keys still work as fallbacks when the scoped form is unset: `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GEMINI_API_KEY`. `OPENCODE_DATA_DIR` (OpenCode's own env) is unchanged — our adapter honors it as-is.
30
+
31
+ ### Documented
32
+
33
+ - `AGENT_KNOWLEDGE_INDEX_VERBATIM`, `AGENT_KNOWLEDGE_EMBEDDING_THREADS`, `AGENT_KNOWLEDGE_EMBEDDING_MODEL` — existed but were missing from the README table.
34
+ - `AGENT_KNOWLEDGE_AUTOWAKE`, `AGENT_KNOWLEDGE_WAKEUP_BUDGET`, `AGENT_KNOWLEDGE_FIRSTPROMPT_INJECT`, `AGENT_KNOWLEDGE_FIRSTPROMPT_BUDGET`, `AGENT_KNOWLEDGE_FIRSTPROMPT_MAX_HITS`, `AGENT_KNOWLEDGE_PRECOMPACT_NUDGE` — hook env vars were in `docs/hooks.md` but not surfaced in the main README table. Fixed.
35
+
36
+ ### Fixed
37
+
38
+ - README `AGENT_KNOWLEDGE_DATA_DIR` description no longer says "Claude Code JSONL files" — the adapter registry is multi-host by design and the description now reflects that.
39
+
3
40
  ## 1.8.1 (2026-04-18) — staleness signal + search-gap log + section-priority context + dashboard polish + access-tracking measurement fix
4
41
 
5
42
  Additive upgrades. Response shapes gain new optional fields (`freshness` on search hits, `evergreen`/`author`/`last_accessed` on `GET /api/knowledge` rows, three new fields on `StalenessSignal`) but no existing fields were removed or reshaped — strict consumers relying on unknown-field tolerance are unaffected. Every new behaviour is automatic or additive — no agent-proactive action required.
package/README.md CHANGED
@@ -36,32 +36,37 @@ Sessions from all major AI coding assistants are auto-discovered -- if a tool is
36
36
 
37
37
  | Tool | Format | Auto-detected path |
38
38
  | ---------------- | -------------- | --------------------------------------------------------------- |
39
- | **Claude Code** | JSONL | `$KNOWLEDGE_DATA_DIR/projects/` (default `~/.claude/projects/`) |
39
+ | **Claude Code** | JSONL | `~/.claude/projects/` |
40
40
  | **Cursor** | JSONL | `~/.cursor/projects/*/agent-transcripts/` |
41
- | **OpenCode** | SQLite | `~/.local/share/opencode/opencode.db` (or `$OPENCODE_DATA_DIR`) |
42
- | **Cline** | JSON | VS Code globalStorage `saoudrizwan.claude-dev/tasks/` |
43
- | **Continue.dev** | JSON | `~/.continue/sessions/` |
41
+ | **Codex CLI** | JSONL | `~/.codex/projects/` |
44
42
  | **Aider** | Markdown/JSONL | `.aider.chat.history.md` / `.aider.llm.history` in project dirs |
43
+ | **Continue.dev** | JSON | `~/.continue/projects/` |
44
+ | **Cline** | JSON | VS Code globalStorage `saoudrizwan.claude-dev/tasks/` |
45
+ | **OpenCode** | SQLite | `~/.local/share/opencode/opencode.db` (or `$OPENCODE_DATA_DIR`) |
45
46
 
46
- No configuration needed. Additional session roots can be added via the `EXTRA_SESSION_ROOTS` env var (comma-separated paths).
47
+ No configuration needed. Additional session roots can be added via the `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` env var (comma-separated paths).
47
48
 
48
49
  ## Features
49
50
 
50
- - **Multi-tool session search** -- unified search across Claude Code, Cursor, OpenCode, Cline, Continue.dev, and Aider sessions
51
+ - **Host-agnostic session search** -- unified search across every major AI coding assistant (Claude Code, Cursor, Codex CLI, Aider, Continue.dev, Cline, OpenCode). No host name is baked into configuration — the adapter registry probes installed host roots at startup.
51
52
  - **Hybrid search** -- semantic vector similarity blended with TF-IDF keyword ranking
52
53
  - **Git-synced knowledge base** -- markdown vault with YAML frontmatter, auto commit and push on writes
54
+ - **Automatic staleness detection (v1.8.1)** -- `knowledge_analyze(action: "stale_by_code_activity")` cross-references file paths mentioned in each entry body against `filesModified` in recent session summaries. Pairs with a symbol-presence precision layer: identifiers the entry quotes (inline backticks + fenced blocks) are checked in the touched file; if they still exist, confidence downweights ×0.3. Entries with `evergreen: true` are exempt.
55
+ - **Search-gap tracking (v1.8.1)** -- `knowledge_analyze(action: "search_gaps")` surfaces zero-result queries over the last `since_days`, grouped by token-Jaccard similarity. The clearest signal for "what entries should I write next?".
56
+ - **Section-priority context packer (v1.8.1)** -- `knowledge(action: "wakeup")` assembles a multi-section bundle (`identity` → `active_tasks` → `recent_decisions` → `known_gotchas` → `last_session_summary` → `top_weighted` → `semantic_fallback`) within a token budget. Unused section budget redistributes to later sections.
53
57
  - **Scored + gated promoter (v1.8)** -- session insights promoted via a 6-signal weighted scorer with three independent gates (`minScore`, `minRecallCount`, `minUniqueQueries`). Runs automatically in background, on demand via `knowledge_admin(action: "promote")`, or benchable offline via `npm run bench:promote`. Emits an auditable `.dreams/YYYY-MM-DD.md` diary every run. Replaces the regex-only distiller.
54
58
  - **Pluggable adapter system** -- add support for new tools by implementing the `SessionAdapter` interface
55
59
  - **Embeddings** -- local (Hugging Face), OpenAI, Claude/Voyage, or Gemini providers
56
60
  - **Fuzzy matching** -- typo-tolerant search using Levenshtein distance
57
61
  - **6 search scopes** -- errors, plans, configs, tools, files, decisions
58
62
  - **6 MCP tools** -- consolidated action-based interface (`knowledge`, `knowledge_search`, `knowledge_session`, `knowledge_graph`, `knowledge_analyze`, `knowledge_admin`)
59
- - **Wakeup context (L0+L1)** -- `knowledge` action `wakeup` returns a token-budgeted identity + top-weight entries blob for session-start hydration
63
+ - **Evergreen entries (v1.8)** -- `evergreen: true` in frontmatter exempts an entry from decay in ranking AND makes it append-only under promotion. Dashboard renders a push-pin badge on these cards.
64
+ - **Author attribution (v1.8.1)** -- optional `author: <string>` frontmatter surfaces as a muted chip on each card.
60
65
  - **Code graph resolution** -- `calls`, `imports`, `inherits` edge types for code structure; directed BFS traversal (`outbound`/`inbound`/`both`); `bulk_link` for efficient ingestion; `unlink_by_origin` for clearing stale code edges before re-ingest; `code:` prefixed node IDs distinguish code from knowledge
61
66
  - **Temporal knowledge graph** -- edges support `valid_from` / `valid_to` validity windows; `as_of` queries return point-in-time snapshots; `invalidate` action marks facts as ended without deleting them
62
67
  - **Hybrid scoring boosts** -- proper-noun and temporal-proximity boosts on top of TF-IDF + semantic blend, capped at +66.7%, short-circuit when no signals are present
63
68
  - **Category as boost (not filter)** -- opt into `category_mode: "boost"` so a wrong category guess down-ranks instead of discarding the right answer
64
- - **Verbatim session indexing** -- per-message chunks (≥30 chars) embedded into the vector store so raw conversation is retrievable; toggle with `KNOWLEDGE_INDEX_VERBATIM=false`
69
+ - **Verbatim session indexing** -- per-message chunks (≥30 chars) embedded into the vector store so raw conversation is retrievable; toggle with `AGENT_KNOWLEDGE_INDEX_VERBATIM=false`
65
70
  - **Configurable git URL** -- `knowledge_admin(action: "config")` for runtime setup, persisted at XDG/AppData location
66
71
  - **Cross-machine persistence** -- knowledge syncs via git, sessions read from local storage of each tool
67
72
  - **Real-time dashboard** -- browse, search, and manage at `localhost:3423`
@@ -76,6 +81,9 @@ No configuration needed. Additional session roots can be added via the `EXTRA_SE
76
81
  - **Knowledge brief** — `knowledge_analyze(action: "brief")` returns a cached ~200 token summary (core concepts, active projects, recent decisions, stale and gap counts) for session-start orientation
77
82
  - **Edge provenance** — graph edges track `origin` (manual, auto-link, distill, reflect) so analysis can distinguish user judgment from automated heuristics
78
83
  - **Deterministic pre-extraction in distillation** — session summaries now include git commits, error patterns, URLs accessed, and packages changed extracted via regex from bash/tool output (no LLM cost)
84
+ - **Freshness metadata on every search hit (v1.8.1)** — every knowledge result carries `freshness: { body_age_days, last_accessed, access_count, verified_at, verification_age_days, evergreen }`. Agent reads the trust signal and decides; we impose no policy demotion.
85
+ - **Per-category decay windows (v1.8.1)** — the "Unused" filter and bytype chart honor per-category thresholds (projects 180d, people 365d, decisions 90d, workflows 60d, notes 30d) so identity-shaped content doesn't look stale just because it isn't re-read weekly.
86
+ - **Lifecycle hooks** — `SessionStart` auto-wakeup, `UserPromptSubmit` first-prompt targeted injection, `PreCompact` memory-flush nudge. Every hook is fail-open and toggleable via an `AGENT_KNOWLEDGE_*` env var.
79
87
 
80
88
  ## Codebase Ingestion
81
89
 
@@ -381,19 +389,56 @@ npm run lint # Type-check (tsc --noEmit)
381
389
 
382
390
  ## Environment Variables
383
391
 
384
- | Variable | Default | Description |
385
- | --------------------------------------------------- | ------------------- | --------------------------------------------------------------------- |
386
- | `KNOWLEDGE_MEMORY_DIR` | `~/agent-knowledge` | Path to git-synced knowledge base |
387
- | `KNOWLEDGE_GIT_URL` | -- | Git remote URL (auto-clones if dir missing) |
388
- | `KNOWLEDGE_AUTO_DISTILL` | `true` | Auto-distill session insights to knowledge base |
389
- | `KNOWLEDGE_EMBEDDING_PROVIDER` | `local` | Embedding provider: `local`, `openai`, `claude`, `gemini` |
390
- | `KNOWLEDGE_EMBEDDING_ALPHA` | `0.3` | TF-IDF vs semantic blend weight (0=pure semantic, 1=pure TF-IDF) |
391
- | `KNOWLEDGE_EMBEDDING_IDLE_TIMEOUT` | `60` | Seconds before unloading local model from memory (0 = keep alive) |
392
- | `KNOWLEDGE_DATA_DIR` | `~/.claude` | Primary session data directory (Claude Code JSONL files) |
393
- | `EXTRA_SESSION_ROOTS` | -- | Additional session directories, comma-separated paths |
394
- | `OPENCODE_DATA_DIR` | (see below) | Override OpenCode data directory (default: `~/.local/share/opencode`) |
395
- | `KNOWLEDGE_ANTHROPIC_API_KEY` / `ANTHROPIC_API_KEY` | -- | API key for Claude/Voyage embeddings |
396
- | `KNOWLEDGE_PORT` | `3423` | Dashboard HTTP port |
392
+ All env vars live under the `AGENT_KNOWLEDGE_*` prefix. No host name is baked in — the adapter registry auto-detects installed AI coding hosts (`.claude`, `.cursor`, `.codex`, `.aider`, `.continue`, OpenCode) without configuration.
393
+
394
+ ### Core
395
+
396
+ | Variable | Default | Description |
397
+ | ------------------------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
398
+ | `AGENT_KNOWLEDGE_MEMORY_DIR` | `~/agent-knowledge` | Git-synced knowledge base directory |
399
+ | `AGENT_KNOWLEDGE_GIT_URL` | -- | Git remote URL (auto-clones if dir missing) |
400
+ | `AGENT_KNOWLEDGE_AUTO_DISTILL` | `true` | Auto-distill session insights into the knowledge base |
401
+ | `AGENT_KNOWLEDGE_INDEX_VERBATIM` | `true` | Index raw session message chunks into the vector store so conversation is retrievable later. Set `false` to save disk at scale. |
402
+ | `AGENT_KNOWLEDGE_DATA_DIR` | (platform config) | Override the primary host data root. Leave unset in the common case — adapters auto-detect every well-known host root under `~/`. |
403
+ | `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` | -- | Extra session directories, comma-separated. Added to whatever auto-detection finds. |
404
+ | `AGENT_KNOWLEDGE_PORT` | `3423` | Dashboard HTTP/WebSocket port |
405
+
406
+ ### Embeddings
407
+
408
+ | Variable | Default | Description |
409
+ | ---------------------------------------- | ------- | ------------------------------------------------------------------------ |
410
+ | `AGENT_KNOWLEDGE_EMBEDDING_PROVIDER` | `local` | `local` \| `openai` \| `claude` \| `gemini` |
411
+ | `AGENT_KNOWLEDGE_EMBEDDING_ALPHA` | `0.3` | TF-IDF vs semantic blend weight (`0` = pure semantic, `1` = pure TF-IDF) |
412
+ | `AGENT_KNOWLEDGE_EMBEDDING_MODEL` | -- | Override provider default model |
413
+ | `AGENT_KNOWLEDGE_EMBEDDING_IDLE_TIMEOUT` | `60` | Seconds before unloading the local model (`0` = keep loaded) |
414
+ | `AGENT_KNOWLEDGE_EMBEDDING_THREADS` | (auto) | ONNX / OMP thread count for the local provider |
415
+
416
+ ### API keys
417
+
418
+ Project-scoped overrides win over the standard keys. Set either; the scoped form lets you run agent-knowledge with a different key than the rest of your environment.
419
+
420
+ | Variable | Fallback | Description |
421
+ | ----------------------------------- | ------------------- | -------------------------- |
422
+ | `AGENT_KNOWLEDGE_OPENAI_API_KEY` | `OPENAI_API_KEY` | OpenAI embeddings |
423
+ | `AGENT_KNOWLEDGE_ANTHROPIC_API_KEY` | `ANTHROPIC_API_KEY` | Claude / Voyage embeddings |
424
+ | `AGENT_KNOWLEDGE_GEMINI_API_KEY` | `GEMINI_API_KEY` | Gemini embeddings |
425
+
426
+ ### Hooks (v1.8 lifecycle integration)
427
+
428
+ | Variable | Default | Description |
429
+ | -------------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
430
+ | `AGENT_KNOWLEDGE_AUTOWAKE` | `1` | Auto-inject a `knowledge(action: wakeup)` bundle into `SessionStart`. Set `0` to disable. |
431
+ | `AGENT_KNOWLEDGE_WAKEUP_BUDGET` | `800` | Tokens for the wakeup bundle |
432
+ | `AGENT_KNOWLEDGE_FIRSTPROMPT_INJECT` | `1` | Run a targeted `knowledge_search` on the first user prompt and inject top hits. `0` / `false` / `off` to disable. |
433
+ | `AGENT_KNOWLEDGE_FIRSTPROMPT_BUDGET` | `600` | Tokens for first-prompt injection (clamp `[100, 8000]`) |
434
+ | `AGENT_KNOWLEDGE_FIRSTPROMPT_MAX_HITS` | `4` | Max knowledge hits attached to the first prompt (clamp `[1, 20]`) |
435
+ | `AGENT_KNOWLEDGE_PRECOMPACT_NUDGE` | `1` | Before pre-compaction, nudge the agent to save context via `knowledge(action: write)`. `0` disables the nudge; `off` suppresses both nudge and disk dump. |
436
+
437
+ ### External tool overrides
438
+
439
+ | Variable | Default | Description |
440
+ | ------------------- | ------------------------- | --------------------------------------------------------------------------------------- |
441
+ | `OPENCODE_DATA_DIR` | `~/.local/share/opencode` | Override where OpenCode's session DB lives (OpenCode's own env, honored by our adapter) |
397
442
 
398
443
  ## Documentation
399
444
 
@@ -2,7 +2,7 @@
2
2
  "id": "agent-knowledge",
3
3
  "name": "Knowledge",
4
4
  "icon": "psychology",
5
- "version": "1.8.1",
5
+ "version": "1.9.0",
6
6
  "description": "Knowledge base — entries, sessions, search, graph relationships",
7
7
  "ui": "./dist/ui/app.js",
8
8
  "css": "./dist/ui/styles.css",
@@ -17,7 +17,7 @@ async function createProvider(cfg) {
17
17
  switch (cfg.provider) {
18
18
  case 'local': {
19
19
  const { LocalEmbeddingProvider } = await import('./local.js');
20
- const idleEnv = process.env.KNOWLEDGE_EMBEDDING_IDLE_TIMEOUT;
20
+ const idleEnv = process.env.AGENT_KNOWLEDGE_EMBEDDING_IDLE_TIMEOUT;
21
21
  const idleTimeoutMs = idleEnv !== undefined ? parseInt(idleEnv, 10) * 1000 : 60_000;
22
22
  const provider = new LocalEmbeddingProvider(cfg.modelOverride, undefined, idleTimeoutMs);
23
23
  if (await provider.isAvailable())
@@ -1 +1 @@
1
- {"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/embeddings/factory.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/embeddings/factory.ts"],"names":[],"mappings":"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"}
@@ -7,7 +7,7 @@ let _pipeline = null;
7
7
  let _pipelineLoading = null;
8
8
  let _idleTimer = null;
9
9
  let _idleTimeoutMs = DEFAULT_IDLE_TIMEOUT_MS;
10
- const _numThreads = parseInt(process.env.KNOWLEDGE_EMBEDDING_THREADS ?? String(DEFAULT_NUM_THREADS), 10);
10
+ const _numThreads = parseInt(process.env.AGENT_KNOWLEDGE_EMBEDDING_THREADS ?? String(DEFAULT_NUM_THREADS), 10);
11
11
  process.env.ONNX_NUM_THREADS = String(_numThreads);
12
12
  process.env.OMP_NUM_THREADS = String(_numThreads);
13
13
  async function loadPipeline(model) {
@@ -1 +1 @@
1
- {"version":3,"file":"local.js","sourceRoot":"","sources":["../../src/embeddings/local.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"local.js","sourceRoot":"","sources":["../../src/embeddings/local.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/embeddings/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,uBAAuB;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,IAAI,eAAe,CASpD"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/embeddings/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,uBAAuB;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,IAAI,eAAe,CAWpD"}
@@ -1,12 +1,14 @@
1
1
  /** Read embedding configuration from environment variables. */
2
2
  export function getEmbeddingConfig() {
3
3
  return {
4
- provider: process.env.KNOWLEDGE_EMBEDDING_PROVIDER || 'local',
5
- alpha: parseFloat(process.env.KNOWLEDGE_EMBEDDING_ALPHA || '0.3'),
6
- openaiApiKey: process.env.KNOWLEDGE_OPENAI_API_KEY || process.env.OPENAI_API_KEY,
7
- anthropicApiKey: process.env.KNOWLEDGE_ANTHROPIC_API_KEY || process.env.ANTHROPIC_API_KEY,
8
- geminiApiKey: process.env.KNOWLEDGE_GEMINI_API_KEY || process.env.GEMINI_API_KEY,
9
- modelOverride: process.env.KNOWLEDGE_EMBEDDING_MODEL,
4
+ provider: process.env.AGENT_KNOWLEDGE_EMBEDDING_PROVIDER || 'local',
5
+ alpha: parseFloat(process.env.AGENT_KNOWLEDGE_EMBEDDING_ALPHA || '0.3'),
6
+ // Project-scoped overrides for third-party keys win over the standard
7
+ // `ANTHROPIC_API_KEY` / `OPENAI_API_KEY` / `GEMINI_API_KEY` fallbacks.
8
+ openaiApiKey: process.env.AGENT_KNOWLEDGE_OPENAI_API_KEY || process.env.OPENAI_API_KEY,
9
+ anthropicApiKey: process.env.AGENT_KNOWLEDGE_ANTHROPIC_API_KEY || process.env.ANTHROPIC_API_KEY,
10
+ geminiApiKey: process.env.AGENT_KNOWLEDGE_GEMINI_API_KEY || process.env.GEMINI_API_KEY,
11
+ modelOverride: process.env.AGENT_KNOWLEDGE_EMBEDDING_MODEL,
10
12
  };
11
13
  }
12
14
  //# sourceMappingURL=types.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/embeddings/types.ts"],"names":[],"mappings":"AAuCA,+DAA+D;AAC/D,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,QAAQ,EAAG,OAAO,CAAC,GAAG,CAAC,4BAA6C,IAAI,OAAO;QAC/E,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,KAAK,CAAC;QACjE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QAChF,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB;QACzF,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QAChF,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB;KACrD,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/embeddings/types.ts"],"names":[],"mappings":"AAuCA,+DAA+D;AAC/D,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,QAAQ,EAAG,OAAO,CAAC,GAAG,CAAC,kCAAmD,IAAI,OAAO;QACrF,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,+BAA+B,IAAI,KAAK,CAAC;QACvE,sEAAsE;QACtE,uEAAuE;QACvE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QACtF,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,iCAAiC,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC/F,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QACtF,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,+BAA+B;KAC3D,CAAC;AACJ,CAAC"}
package/dist/index.js CHANGED
@@ -3,7 +3,7 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
3
3
  import { createServer } from './server.js';
4
4
  import { startDashboard } from './dashboard.js';
5
5
  async function main() {
6
- const port = parseInt(process.env.KNOWLEDGE_PORT || '3423', 10);
6
+ const port = parseInt(process.env.AGENT_KNOWLEDGE_PORT || '3423', 10);
7
7
  let isLeader = false;
8
8
  try {
9
9
  await startDashboard(port);
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IAEhE,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,IAAI,IAAI,CAAC,CAAC;QAC9D,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8BAA8B,IAAI,yCAAyC,CAC5E,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IAEtE,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,IAAI,IAAI,CAAC,CAAC;QAC9D,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8BAA8B,IAAI,yCAAyC,CAC5E,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,YAAY,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAC;CACxB;AAID,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAaD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,mBAAmB,IAAI,eAAe,CASrD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAgBtF;AAID,wBAAgB,SAAS,IAAI,eAAe,CAkE3C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,YAAY,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAC;CACxB;AAID,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAaD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,mBAAmB,IAAI,eAAe,CASrD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAgBtF;AAID,wBAAgB,SAAS,IAAI,eAAe,CAoE3C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}
package/dist/types.js CHANGED
@@ -47,14 +47,16 @@ export function savePersistedConfig(updates) {
47
47
  // ── Config resolution (env vars > persisted config > defaults) ──────────────
48
48
  export function getConfig() {
49
49
  const home = homedir();
50
- // KNOWLEDGE_DATA_DIR is optional — defaults to platform config dir.
51
- const dataDir = process.env.KNOWLEDGE_DATA_DIR || getConfigDir();
50
+ // Primary host data root override — defaults to the platform config dir
51
+ // when unset. Most deployments leave it unset and rely on the adapter
52
+ // registry's multi-host auto-detection instead.
53
+ const dataDir = process.env.AGENT_KNOWLEDGE_DATA_DIR || getConfigDir();
52
54
  const persisted = loadPersistedConfig();
53
- const memoryDir = process.env.KNOWLEDGE_MEMORY_DIR || persisted.memoryDir || join(home, 'agent-knowledge');
55
+ const memoryDir = process.env.AGENT_KNOWLEDGE_MEMORY_DIR || persisted.memoryDir || join(home, 'agent-knowledge');
54
56
  const sessionsDir = join(dataDir, 'projects');
55
57
  // Extra session roots: from env var (comma-separated) + auto-detected editors
56
58
  const extraSessionRoots = [];
57
- const envRoots = process.env.EXTRA_SESSION_ROOTS;
59
+ const envRoots = process.env.AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS;
58
60
  if (envRoots) {
59
61
  for (const r of envRoots.split(',')) {
60
62
  const trimmed = r.trim();
@@ -77,16 +79,16 @@ export function getConfig() {
77
79
  extraSessionRoots.push(root);
78
80
  }
79
81
  }
80
- const embeddingProvider = process.env.KNOWLEDGE_EMBEDDING_PROVIDER ||
82
+ const embeddingProvider = process.env.AGENT_KNOWLEDGE_EMBEDDING_PROVIDER ||
81
83
  persisted.embeddingProvider ||
82
84
  'local';
83
- const embeddingAlpha = parseFloat(process.env.KNOWLEDGE_EMBEDDING_ALPHA || String(persisted.embeddingAlpha ?? 0.3));
84
- const gitUrl = process.env.KNOWLEDGE_GIT_URL || persisted.gitUrl || undefined;
85
- const autoDistillEnv = process.env.KNOWLEDGE_AUTO_DISTILL;
85
+ const embeddingAlpha = parseFloat(process.env.AGENT_KNOWLEDGE_EMBEDDING_ALPHA || String(persisted.embeddingAlpha ?? 0.3));
86
+ const gitUrl = process.env.AGENT_KNOWLEDGE_GIT_URL || persisted.gitUrl || undefined;
87
+ const autoDistillEnv = process.env.AGENT_KNOWLEDGE_AUTO_DISTILL;
86
88
  const autoDistill = autoDistillEnv !== undefined
87
89
  ? autoDistillEnv.toLowerCase() !== 'false'
88
90
  : (persisted.autoDistill ?? true);
89
- const indexVerbatimEnv = process.env.KNOWLEDGE_INDEX_VERBATIM;
91
+ const indexVerbatimEnv = process.env.AGENT_KNOWLEDGE_INDEX_VERBATIM;
90
92
  const indexVerbatim = indexVerbatimEnv !== undefined
91
93
  ? indexVerbatimEnv.toLowerCase() !== 'false'
92
94
  : (persisted.indexVerbatim ?? true);
package/dist/types.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
@@ -230,7 +230,19 @@ finalScore = baseRelevance * 0.5^(daysSinceLastAccess / 90) * maturityMultiplier
230
230
  | `established` | 5-19 | 1.0x |
231
231
  | `proven` | 20+ | 1.5x |
232
232
 
233
- Access count increments on `knowledge { action: "read" }`. Maturity transitions happen automatically when thresholds are crossed. Search results from `knowledge_search` apply the decay formula to blend relevance with freshness and confidence.
233
+ Access count increments on every path that actually feeds a knowledge entry into the agent's context: `knowledge { action: "read" }`, the session-start `wakeup` bundle (every entry packed in bumps access), and every `knowledge_search` hit on a knowledge entry. Sessions hits don't bump. Maturity transitions happen automatically when thresholds are crossed. Search results from `knowledge_search` apply the decay formula to blend relevance with freshness and confidence.
234
+
235
+ ### freshness.ts (v1.8.1)
236
+
237
+ Automatic staleness detector. For each entry, extracts the file paths it mentions and cross-references them against `filesModified` in recent session summaries; an entry whose mentioned file was modified AFTER the entry's body mtime is a candidate.
238
+
239
+ Precision layer: extracts identifiers the entry quotes (inline backticks + fenced blocks, strict-identifier shape, ≥3 chars) and checks whether they still appear in the touched files. Confidence multiplies by `0.3` when every named symbol is still present (entry's concrete claims likely hold), linearly scales for partial matches, keeps full weight when all named symbols are missing. Entries that quote no verifiable identifiers fall through with `symbol_evidence: "not_applicable"`.
240
+
241
+ Entries with `evergreen: true` are exempt from the whole pass.
242
+
243
+ ### query-log.ts (v1.8.1)
244
+
245
+ Lightweight `query_log` table inside `knowledge-scores.db`. Every `knowledge_search` call is logged with `{query, project, results_count, created_at}`; obvious-secret patterns (API keys, JWTs, bearer tokens, `.env`-style assignments) are scrubbed via `scrubContent` before insert. `knowledge_analyze(action: "search_gaps")` groups zero-result queries by token-Jaccard similarity (default `0.35`) and returns them ranked by frequency — the strongest signal for "what entries should I write next?".
234
246
 
235
247
  ## Memory Consolidation
236
248
 
@@ -295,9 +307,9 @@ The `edges` table has an additional `origin TEXT NOT NULL DEFAULT 'manual'` colu
295
307
 
296
308
  Sessions are read from multiple AI coding tools through two mechanisms:
297
309
 
298
- 1. **Direct parsing** -- Claude Code and Cursor sessions use JSONL files read directly by `parser.ts`. Claude Code sessions come from the primary data directory (`$KNOWLEDGE_DATA_DIR/projects/`). Cursor sessions are auto-discovered from `~/.cursor/projects/*/agent-transcripts/`.
310
+ 1. **Direct parsing** -- JSONL-based hosts (Claude Code, Cursor, Codex CLI, Continue.dev) are read directly by `parser.ts`. The adapter registry probes each known host root under `~/` (`.claude/projects/`, `.cursor/projects/`, `.codex/projects/`, `.aider/…`, `.continue/projects/`) and merges them into the session index. `AGENT_KNOWLEDGE_DATA_DIR` overrides the primary root; `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` adds more.
299
311
 
300
- 2. **Adapter dispatch** -- Other tools (OpenCode, Cline, Continue.dev, Aider) use the pluggable adapter system in `adapters/`. When `parseSessionFile()` receives a virtual descriptor (e.g. `opencode://session:abc`), it dispatches to the matching adapter.
312
+ 2. **Adapter dispatch** -- Tools with custom storage (OpenCode SQLite, Cline VS Code global storage, Aider markdown/JSONL hybrid) go through the pluggable adapter system in `adapters/`. When `parseSessionFile()` receives a virtual descriptor (e.g. `opencode://session:abc`), it dispatches to the matching adapter.
301
313
 
302
314
  ```
303
315
  parseSessionFile(path)
package/docs/DASHBOARD.md CHANGED
@@ -17,6 +17,8 @@ Card grid of knowledge entries. Each card shows:
17
17
 
18
18
  - Category badge with color: projects (blue), people (purple), decisions (orange), workflows (green), notes (yellow)
19
19
  - **Maturity badge**: candidate (gray), established (blue), proven (green) — based on access frequency
20
+ - **Pin badge** (Material Symbols `push_pin`) when the entry has `evergreen: true` frontmatter — these entries are exempt from decay in ranking and append-only under promotion.
21
+ - **Author chip** (muted, footer row) when the entry has `author: <string>` frontmatter — surfaces who wrote or owns it.
20
22
  - Title and tag pills
21
23
  - Last updated date
22
24
 
@@ -24,6 +26,10 @@ Card grid of knowledge entries. Each card shows:
24
26
 
25
27
  Category filter chips at the top: All, Projects, People, Decisions, Workflows, Notes. Search bar for filtering entries by title.
26
28
 
29
+ **Unused filter chip** (top-right of the header): shows `Unused (N)` where `N` is the count of entries past their per-category staleness threshold. Click to filter the grid to just those entries; click again to clear. Auto-hides when the count is zero.
30
+
31
+ **By Type access chart** (between the tabs and the grid): a horizontal bar per canonical category, row-normalized so each bar fills its own track. Green share = accessed within the per-category recent window, orange = unused. Volume comparison via the right-side `accessed/unused` counts. Per-category thresholds: `projects` 180/365d, `people` 365/730d, `decisions` 90/180d, `workflows` 60/120d, `notes` 30/90d.
32
+
27
33
  **Header action buttons:**
28
34
 
29
35
  - **Duplicates** — scans all entries for near-duplicates using TF-IDF similarity. Entries in duplicate clusters get a warning icon on their card. Opens a side panel showing clusters with pairwise similarity scores. Click any entry in a cluster to view it.
package/docs/SETUP.md CHANGED
@@ -75,7 +75,7 @@ This detects Claude Code, registers the MCP server in `~/.claude.json`, wires al
75
75
 
76
76
  ```bash
77
77
  claude mcp add agent-knowledge -s user \
78
- -e KNOWLEDGE_MEMORY_DIR="$HOME/agent-knowledge" \
78
+ -e AGENT_KNOWLEDGE_MEMORY_DIR="$HOME/agent-knowledge" \
79
79
  -- node /path/to/agent-knowledge/dist/index.js
80
80
  ```
81
81
 
@@ -110,8 +110,8 @@ claude mcp list
110
110
  "type": "local",
111
111
  "command": ["node", "/absolute/path/to/agent-knowledge/dist/index.js"],
112
112
  "environment": {
113
- "KNOWLEDGE_MEMORY_DIR": "/home/you/agent-knowledge",
114
- "KNOWLEDGE_PORT": "3423"
113
+ "AGENT_KNOWLEDGE_MEMORY_DIR": "/home/you/agent-knowledge",
114
+ "AGENT_KNOWLEDGE_PORT": "3423"
115
115
  }
116
116
  }
117
117
  }
@@ -129,8 +129,8 @@ claude mcp list
129
129
  "command": "node",
130
130
  "args": ["/absolute/path/to/agent-knowledge/dist/index.js"],
131
131
  "env": {
132
- "KNOWLEDGE_MEMORY_DIR": "/home/you/agent-knowledge",
133
- "KNOWLEDGE_PORT": "3423"
132
+ "AGENT_KNOWLEDGE_MEMORY_DIR": "/home/you/agent-knowledge",
133
+ "AGENT_KNOWLEDGE_PORT": "3423"
134
134
  }
135
135
  }
136
136
  }
@@ -148,8 +148,8 @@ claude mcp list
148
148
  "command": "node",
149
149
  "args": ["/absolute/path/to/agent-knowledge/dist/index.js"],
150
150
  "env": {
151
- "KNOWLEDGE_MEMORY_DIR": "/home/you/agent-knowledge",
152
- "KNOWLEDGE_PORT": "3423"
151
+ "AGENT_KNOWLEDGE_MEMORY_DIR": "/home/you/agent-knowledge",
152
+ "AGENT_KNOWLEDGE_PORT": "3423"
153
153
  }
154
154
  }
155
155
  }
@@ -419,34 +419,34 @@ Architecture notes, deployment info, etc.
419
419
 
420
420
  ## Environment Variables
421
421
 
422
- | Variable | Default | Description |
423
- | --------------------------------------------------- | ------------------- | -------------------------------------------------------------- |
424
- | `KNOWLEDGE_MEMORY_DIR` | `~/agent-knowledge` | Path to git-synced knowledge base |
425
- | `KNOWLEDGE_DATA_DIR` | `~/.claude` | Primary session data directory (Claude Code JSONL) |
426
- | `EXTRA_SESSION_ROOTS` | -- | Additional session directories, comma-separated |
427
- | `OPENCODE_DATA_DIR` | (platform default) | Override OpenCode data dir (default `~/.local/share/opencode`) |
428
- | `KNOWLEDGE_PORT` | `3423` | Dashboard HTTP/WebSocket port |
429
- | `KNOWLEDGE_EMBEDDING_PROVIDER` | `local` | Embedding provider (local, openai, claude, gemini) |
430
- | `KNOWLEDGE_EMBEDDING_ALPHA` | `0.5` | Blend weight for semantic vs TF-IDF search (0-1) |
431
- | `KNOWLEDGE_EMBEDDING_IDLE_TIMEOUT` | — | Idle timeout for embedding worker (ms) |
432
- | `KNOWLEDGE_EMBEDDING_THREADS` | — | Number of ONNX threads for local embeddings |
433
- | `KNOWLEDGE_EMBEDDING_MODEL` | — | Model name for embedding provider |
434
- | `KNOWLEDGE_GIT_URL` | — | Remote git URL for knowledge base sync |
435
- | `KNOWLEDGE_AUTO_DISTILL` | — | Enable auto-distillation of sessions (true/false) |
436
- | `KNOWLEDGE_OPENAI_API_KEY` / `OPENAI_API_KEY` | — | API key for OpenAI embeddings |
437
- | `KNOWLEDGE_ANTHROPIC_API_KEY` / `ANTHROPIC_API_KEY` | — | API key for Claude/Voyage embeddings |
438
- | `KNOWLEDGE_GEMINI_API_KEY` / `GEMINI_API_KEY` | — | API key for Gemini embeddings |
422
+ | Variable | Default | Description |
423
+ | --------------------------------------------------------- | ------------------- | ---------------------------------------------------------------- |
424
+ | `AGENT_KNOWLEDGE_MEMORY_DIR` | `~/agent-knowledge` | Path to git-synced knowledge base |
425
+ | `AGENT_KNOWLEDGE_DATA_DIR` | (platform config) | Override primary host data root (adapters auto-detect otherwise) |
426
+ | `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` | -- | Additional session directories, comma-separated |
427
+ | `OPENCODE_DATA_DIR` | (platform default) | Override OpenCode data dir (default `~/.local/share/opencode`) |
428
+ | `AGENT_KNOWLEDGE_PORT` | `3423` | Dashboard HTTP/WebSocket port |
429
+ | `AGENT_KNOWLEDGE_EMBEDDING_PROVIDER` | `local` | Embedding provider (local, openai, claude, gemini) |
430
+ | `AGENT_KNOWLEDGE_EMBEDDING_ALPHA` | `0.5` | Blend weight for semantic vs TF-IDF search (0-1) |
431
+ | `AGENT_KNOWLEDGE_EMBEDDING_IDLE_TIMEOUT` | — | Idle timeout for embedding worker (ms) |
432
+ | `AGENT_KNOWLEDGE_EMBEDDING_THREADS` | — | Number of ONNX threads for local embeddings |
433
+ | `AGENT_KNOWLEDGE_EMBEDDING_MODEL` | — | Model name for embedding provider |
434
+ | `AGENT_KNOWLEDGE_GIT_URL` | — | Remote git URL for knowledge base sync |
435
+ | `AGENT_KNOWLEDGE_AUTO_DISTILL` | — | Enable auto-distillation of sessions (true/false) |
436
+ | `AGENT_KNOWLEDGE_OPENAI_API_KEY` / `OPENAI_API_KEY` | — | API key for OpenAI embeddings |
437
+ | `AGENT_KNOWLEDGE_ANTHROPIC_API_KEY` / `ANTHROPIC_API_KEY` | — | API key for Claude/Voyage embeddings |
438
+ | `AGENT_KNOWLEDGE_GEMINI_API_KEY` / `GEMINI_API_KEY` | — | API key for Gemini embeddings |
439
439
 
440
440
  Set in your shell profile or pass via MCP config:
441
441
 
442
442
  ```bash
443
- export KNOWLEDGE_MEMORY_DIR="$HOME/agent-knowledge"
443
+ export AGENT_KNOWLEDGE_MEMORY_DIR="$HOME/agent-knowledge"
444
444
  ```
445
445
 
446
446
  On Windows (PowerShell):
447
447
 
448
448
  ```powershell
449
- $env:KNOWLEDGE_MEMORY_DIR = "$env:USERPROFILE\agent-knowledge"
449
+ $env:AGENT_KNOWLEDGE_MEMORY_DIR = "$env:USERPROFILE\agent-knowledge"
450
450
  ```
451
451
 
452
452
  ---
@@ -481,21 +481,21 @@ cd ~/agent-knowledge && git pull && git push # Should work without prompts
481
481
 
482
482
  agent-knowledge auto-discovers sessions from all major AI coding assistants. If a tool is installed on your machine, its sessions appear automatically in search results and the dashboard Sessions tab.
483
483
 
484
- | Tool | Format | Auto-detected path | Override |
485
- | ---------------- | -------------- | --------------------------------------------------------------- | --------------------- |
486
- | **Claude Code** | JSONL | `$KNOWLEDGE_DATA_DIR/projects/` | `KNOWLEDGE_DATA_DIR` |
487
- | **Cursor** | JSONL | `~/.cursor/projects/*/agent-transcripts/` | `EXTRA_SESSION_ROOTS` |
488
- | **OpenCode** | SQLite | `~/.local/share/opencode/opencode.db` | `OPENCODE_DATA_DIR` |
489
- | **Cline** | JSON | VS Code globalStorage `saoudrizwan.claude-dev/tasks/` | -- |
490
- | **Continue.dev** | JSON | `~/.continue/sessions/` | -- |
491
- | **Aider** | Markdown/JSONL | `.aider.chat.history.md` / `.aider.llm.history` in project dirs | -- |
484
+ | Tool | Format | Auto-detected path | Override |
485
+ | ---------------- | -------------- | --------------------------------------------------------------- | ------------------------------------- |
486
+ | **Claude Code** | JSONL | `$AGENT_KNOWLEDGE_DATA_DIR/projects/` | `AGENT_KNOWLEDGE_DATA_DIR` |
487
+ | **Cursor** | JSONL | `~/.cursor/projects/*/agent-transcripts/` | `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` |
488
+ | **OpenCode** | SQLite | `~/.local/share/opencode/opencode.db` | `OPENCODE_DATA_DIR` |
489
+ | **Cline** | JSON | VS Code globalStorage `saoudrizwan.claude-dev/tasks/` | -- |
490
+ | **Continue.dev** | JSON | `~/.continue/sessions/` | -- |
491
+ | **Aider** | Markdown/JSONL | `.aider.chat.history.md` / `.aider.llm.history` in project dirs | -- |
492
492
 
493
493
  ### Adding extra session directories
494
494
 
495
- Use the `EXTRA_SESSION_ROOTS` environment variable to add session directories that are not auto-detected:
495
+ Use the `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` environment variable to add session directories that are not auto-detected:
496
496
 
497
497
  ```bash
498
- export EXTRA_SESSION_ROOTS="/path/to/custom/sessions,/another/path"
498
+ export AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS="/path/to/custom/sessions,/another/path"
499
499
  ```
500
500
 
501
501
  Each path is scanned for JSONL files or Cursor-style `agent-transcripts/` subdirectories.
@@ -518,7 +518,7 @@ netstat -ano | findstr :3423 # Windows
518
518
  lsof -i :3423 # Linux/macOS
519
519
 
520
520
  # Use a different port
521
- export KNOWLEDGE_PORT=3424
521
+ export AGENT_KNOWLEDGE_PORT=3424
522
522
  ```
523
523
 
524
524
  ### Git authentication failures
@@ -563,7 +563,7 @@ ls ~/.continue/sessions/
563
563
  ls ~/projects/*/.aider.chat.history.md
564
564
  ```
565
565
 
566
- If your session data is in a non-standard location, use `EXTRA_SESSION_ROOTS` to point to it.
566
+ If your session data is in a non-standard location, use `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` to point to it.
567
567
 
568
568
  ## Client Comparison
569
569
 
@@ -95,14 +95,14 @@ npx agent-knowledge
95
95
 
96
96
  ### Environment Variables
97
97
 
98
- | Variable | Default | Description |
99
- | ------------------------ | ------------------- | ---------------------------------------------- |
100
- | `KNOWLEDGE_PORT` | `3423` | Dashboard HTTP/WebSocket port |
101
- | `KNOWLEDGE_DATA_DIR` | `~/.claude` | Base directory for Claude Code session data |
102
- | `KNOWLEDGE_GIT_URL` | (none) | Git remote URL for knowledge base sync |
103
- | `KNOWLEDGE_MEMORY_DIR` | `~/agent-knowledge` | Local knowledge base directory |
104
- | `KNOWLEDGE_AUTO_DISTILL` | `true` | Enable/disable session auto-distillation |
105
- | `EXTRA_SESSION_ROOTS` | (none) | Comma-separated additional session directories |
98
+ | Variable | Default | Description |
99
+ | ------------------------------------- | ------------------- | ----------------------------------------------- |
100
+ | `AGENT_KNOWLEDGE_PORT` | `3423` | Dashboard HTTP/WebSocket port |
101
+ | `AGENT_KNOWLEDGE_DATA_DIR` | (platform config) | Override primary host data root (auto-detected) |
102
+ | `AGENT_KNOWLEDGE_GIT_URL` | (none) | Git remote URL for knowledge base sync |
103
+ | `AGENT_KNOWLEDGE_MEMORY_DIR` | `~/agent-knowledge` | Local knowledge base directory |
104
+ | `AGENT_KNOWLEDGE_AUTO_DISTILL` | `true` | Enable/disable session auto-distillation |
105
+ | `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` | (none) | Comma-separated additional session directories |
106
106
 
107
107
  ### Claude Code Setup
108
108
 
@@ -147,7 +147,7 @@ knowledge_admin with action "config", auto_distill false
147
147
 
148
148
  ### Accessing the Dashboard
149
149
 
150
- The dashboard is available at **http://localhost:3423** (or the port configured via `KNOWLEDGE_PORT`).
150
+ The dashboard is available at **http://localhost:3423** (or the port configured via `AGENT_KNOWLEDGE_PORT`).
151
151
 
152
152
  ### Knowledge Tab
153
153
 
@@ -901,13 +901,13 @@ On server startup (when `auto_distill` is enabled), past sessions are automatica
901
901
 
902
902
  Sessions are auto-discovered from installed AI coding tools:
903
903
 
904
- | Tool | Location |
905
- | ----------- | ------------------------------------------------- |
906
- | Claude Code | `$KNOWLEDGE_DATA_DIR/projects/` (JSONL files) |
907
- | Cursor | `~/.cursor/projects/*/agent-transcripts/` (JSONL) |
908
- | OpenCode | `~/.local/share/opencode/opencode.db` (SQLite) |
904
+ | Tool | Location |
905
+ | ----------- | --------------------------------------------------- |
906
+ | Claude Code | `$AGENT_KNOWLEDGE_DATA_DIR/projects/` (JSONL files) |
907
+ | Cursor | `~/.cursor/projects/*/agent-transcripts/` (JSONL) |
908
+ | OpenCode | `~/.local/share/opencode/opencode.db` (SQLite) |
909
909
 
910
- Additional roots can be added via `EXTRA_SESSION_ROOTS` (comma-separated paths).
910
+ Additional roots can be added via `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` (comma-separated paths).
911
911
 
912
912
  ### Search Modes
913
913
 
@@ -956,14 +956,14 @@ If no provider is available, search falls back to pure TF-IDF.
956
956
 
957
957
  **Solutions:**
958
958
 
959
- 1. Set `KNOWLEDGE_PORT=3424` in the MCP config env.
959
+ 1. Set `AGENT_KNOWLEDGE_PORT=3424` in the MCP config env.
960
960
  2. Multiple MCP instances share the same database. Only one serves the dashboard.
961
961
 
962
962
  ### Search Returns No Results
963
963
 
964
964
  **Causes and solutions:**
965
965
 
966
- - **No sessions found**: Check that `KNOWLEDGE_DATA_DIR` points to the correct directory. Verify session files exist.
966
+ - **No sessions found**: Check that `AGENT_KNOWLEDGE_DATA_DIR` points to the correct directory. Verify session files exist.
967
967
  - **Embeddings not available**: Semantic search requires an API key. Check the embedding provider configuration.
968
968
  - **Index not built**: Background indexing runs 5 seconds after startup. Wait for it to complete. Check stderr for `[knowledge] Background index` messages.
969
969
 
@@ -995,7 +995,7 @@ If no provider is available, search falls back to pure TF-IDF.
995
995
  **Solutions:**
996
996
 
997
997
  - The default directory is `~/agent-knowledge/`. Create it manually or let the git clone create it.
998
- - Override via `KNOWLEDGE_MEMORY_DIR` or `knowledge_admin(action: "config", memory_dir: "/path")`.
998
+ - Override via `AGENT_KNOWLEDGE_MEMORY_DIR` or `knowledge_admin(action: "config", memory_dir: "/path")`.
999
999
 
1000
1000
  ---
1001
1001
 
@@ -1007,7 +1007,7 @@ Yes. agent-knowledge is a standard MCP server. It also auto-discovers sessions f
1007
1007
 
1008
1008
  ### Where are knowledge entries stored?
1009
1009
 
1010
- In `~/agent-knowledge/` by default (configurable via `KNOWLEDGE_MEMORY_DIR`). Entries are plain Markdown files with YAML frontmatter, organized in category subdirectories.
1010
+ In `~/agent-knowledge/` by default (configurable via `AGENT_KNOWLEDGE_MEMORY_DIR`). Entries are plain Markdown files with YAML frontmatter, organized in category subdirectories.
1011
1011
 
1012
1012
  ### How does git sync work?
1013
1013
 
@@ -1040,4 +1040,4 @@ The distillation process applies regex patterns to detect and remove common secr
1040
1040
 
1041
1041
  ### Can I disable auto-distillation?
1042
1042
 
1043
- Yes. Set `KNOWLEDGE_AUTO_DISTILL=false` as an environment variable, or use `knowledge_admin(action: "config", auto_distill: false)`.
1043
+ Yes. Set `AGENT_KNOWLEDGE_AUTO_DISTILL=false` as an environment variable, or use `knowledge_admin(action: "config", auto_distill: false)`.
package/docs/hooks.md CHANGED
@@ -61,7 +61,7 @@ so the user's next real question still gets injection.
61
61
  | `AGENT_KNOWLEDGE_FIRSTPROMPT_INJECT` | `1` | Set `0` / `false` / `off` to disable |
62
62
  | `AGENT_KNOWLEDGE_FIRSTPROMPT_BUDGET` | `600` | Max tokens (chars/4 estimate), clamped to `[100, 8000]` |
63
63
  | `AGENT_KNOWLEDGE_FIRSTPROMPT_MAX_HITS` | `4` | Max rendered entries, clamped to `[1, 20]` |
64
- | `KNOWLEDGE_MEMORY_DIR` | `~/agent-knowledge` | Knowledge base to search |
64
+ | `AGENT_KNOWLEDGE_MEMORY_DIR` | `~/agent-knowledge` | Knowledge base to search |
65
65
 
66
66
  ## precompact-flush.mjs
67
67
 
@@ -79,7 +79,7 @@ Called right before the host compacts the transcript. Two jobs:
79
79
 
80
80
  | Variable | Default | Description |
81
81
  | ---------------------------------- | ------------------- | ---------------------------------------------------------------------------------------------------- |
82
- | `KNOWLEDGE_MEMORY_DIR` | `~/agent-knowledge` | Where rich summaries are written |
82
+ | `AGENT_KNOWLEDGE_MEMORY_DIR` | `~/agent-knowledge` | Where rich summaries are written |
83
83
  | `AGENT_KNOWLEDGE_PRECOMPACT_NUDGE` | `1` | Set `0` / `false` to disable the nudge only. Set `off` to suppress both the nudge AND the disk dump. |
84
84
 
85
85
  ## precompact-distill.mjs
@@ -87,22 +87,22 @@ Called right before the host compacts the transcript. Two jobs:
87
87
  A simpler heuristic companion to `precompact-flush.mjs`. Reads the last
88
88
  ~200 KB of the transcript JSONL, extracts the last 10 user prompts, and
89
89
  writes them to
90
- `~/claude-memory/projects/precompact-<slug>-<session>.md`. This one does
90
+ `~/agent-knowledge/projects/precompact-<slug>-<session>.md`. This one does
91
91
  not require the library to be built, so it still works when `dist/` is
92
92
  missing. Running both is fine — they target different files.
93
93
 
94
94
  ### Environment variables
95
95
 
96
- | Variable | Default | Description |
97
- | ---------------------- | ----------------- | ------------------------------------------------- |
98
- | `KNOWLEDGE_MEMORY_DIR` | `~/claude-memory` | Where the snapshot is written (`<dir>/projects/`) |
96
+ | Variable | Default | Description |
97
+ | ---------------------------- | ------------------- | ------------------------------------------------- |
98
+ | `AGENT_KNOWLEDGE_MEMORY_DIR` | `~/agent-knowledge` | Where the snapshot is written (`<dir>/projects/`) |
99
99
 
100
100
  ## sessionend-distill.mjs
101
101
 
102
102
  On `SessionEnd`, walks the whole transcript JSONL, counts user / assistant
103
103
  turns and `tool_use` blocks, collects the first 20 user prompts, and writes
104
104
  a markdown summary to
105
- `~/claude-memory/projects/session-<slug>-<session>.md`. Gives
105
+ `~/agent-knowledge/projects/session-<slug>-<session>.md`. Gives
106
106
  agent-knowledge a breadcrumb for later session search/recall.
107
107
 
108
108
  ## Manual configuration
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-knowledge",
3
- "version": "1.8.1",
3
+ "version": "1.9.0",
4
4
  "description": "Cross-session memory and recall for AI agents — git-synced knowledge base, knowledge graph, confidence scoring, hybrid semantic+TF-IDF search, auto-distillation with secrets scrubbing",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -23,7 +23,7 @@
23
23
  // AGENT_KNOWLEDGE_FIRSTPROMPT_INJECT (default "1") — set "0" to disable
24
24
  // AGENT_KNOWLEDGE_FIRSTPROMPT_BUDGET (default "600") — max chars/4 tokens
25
25
  // AGENT_KNOWLEDGE_FIRSTPROMPT_MAX_HITS (default "4") — cap on rendered hits
26
- // KNOWLEDGE_MEMORY_DIR — resolves memory dir (same as core)
26
+ // AGENT_KNOWLEDGE_MEMORY_DIR — resolves memory dir (same as core)
27
27
  //
28
28
  // Fail-open: every error path prints `{}` so the host never blocks on this
29
29
  // hook. Log-only stderr for diagnostics.
@@ -75,11 +75,11 @@ function maxHits() {
75
75
  }
76
76
 
77
77
  function memoryDir() {
78
- return process.env.KNOWLEDGE_MEMORY_DIR || path.join(homedir(), 'agent-knowledge');
78
+ return process.env.AGENT_KNOWLEDGE_MEMORY_DIR || path.join(homedir(), 'agent-knowledge');
79
79
  }
80
80
 
81
81
  function dataDir() {
82
- if (process.env.KNOWLEDGE_DATA_DIR) return process.env.KNOWLEDGE_DATA_DIR;
82
+ if (process.env.AGENT_KNOWLEDGE_DATA_DIR) return process.env.AGENT_KNOWLEDGE_DATA_DIR;
83
83
  if (process.platform === 'win32') {
84
84
  return path.join(
85
85
  process.env.APPDATA || path.join(homedir(), 'AppData', 'Roaming'),
@@ -23,7 +23,7 @@ process.on('uncaughtException', (err) => {
23
23
  process.exit(0);
24
24
  });
25
25
 
26
- const MEMORY_DIR = process.env.KNOWLEDGE_MEMORY_DIR || join(homedir(), 'claude-memory');
26
+ const MEMORY_DIR = process.env.AGENT_KNOWLEDGE_MEMORY_DIR || join(homedir(), 'agent-knowledge');
27
27
 
28
28
  async function main() {
29
29
  let input = '';
@@ -88,7 +88,7 @@ function slugify(input) {
88
88
  }
89
89
 
90
90
  function memoryDir() {
91
- return process.env.KNOWLEDGE_MEMORY_DIR || join(homedir(), 'agent-knowledge');
91
+ return process.env.AGENT_KNOWLEDGE_MEMORY_DIR || join(homedir(), 'agent-knowledge');
92
92
  }
93
93
 
94
94
  async function dumpSummaryToDisk({ sessionId, event, cwd, projectSlug }) {
@@ -21,7 +21,7 @@ process.on('uncaughtException', (err) => {
21
21
  process.exit(0);
22
22
  });
23
23
 
24
- const MEMORY_DIR = process.env.KNOWLEDGE_MEMORY_DIR || join(homedir(), 'claude-memory');
24
+ const MEMORY_DIR = process.env.AGENT_KNOWLEDGE_MEMORY_DIR || join(homedir(), 'agent-knowledge');
25
25
 
26
26
  async function main() {
27
27
  let input = '';
package/scripts/setup.js CHANGED
@@ -211,7 +211,7 @@ Restart Claude Code to load the new MCP server. Every session will now:
211
211
  - Dump a final session summary on exit (sessionend-distill)
212
212
 
213
213
  Dashboard: http://localhost:3423 (auto-starts on first MCP connection)
214
- Knowledge base: ~/claude-memory/ (configurable via KNOWLEDGE_MEMORY_DIR)
214
+ Knowledge base: ~/agent-knowledge/ (configurable via AGENT_KNOWLEDGE_MEMORY_DIR)
215
215
 
216
216
  See docs/hooks.md for details and docs/SETUP.md for manual configuration.
217
217
  `);