stifler-memex-mcp 0.9.0 → 1.0.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 +35 -12
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,20 +1,23 @@
1
- # memex — trusted engineering context for agentic software engineering
1
+ # memex: trusted engineering context for agentic software engineering
2
2
 
3
3
  <!-- mcp-name: io.github.STiFLeR7/memex -->
4
4
 
5
5
  > A protocol-neutral engineering-context layer for AI coding agents. memex
6
- > builds a bitemporal knowledge graph of your repository — modules, symbols,
7
- > decisions, problems, evidence, and code evolution — and exposes bounded,
6
+ > builds a bitemporal knowledge graph of your repository (modules, symbols,
7
+ > decisions, problems, evidence, and code evolution) and exposes bounded,
8
8
  > provenance-aware context through Hermes MemoryProvider or MCP.
9
9
 
10
+ **[memex.stifler.in](https://memex.stifler.in)**
11
+
10
12
  A daemon and MCP server that turns commits and file changes into structured
11
13
  engineering knowledge. Agents can receive relevant repository context before a
12
14
  task, with freshness and provenance preserved, without making memex a source of
13
15
  personal memory or raw session state.
14
16
 
15
- [![PyPI](https://img.shields.io/pypi/v/memex-mcp?v=0.9.0)](https://pypi.org/project/memex-mcp/)
17
+ [![Website](https://img.shields.io/badge/website-memex.stifler.in-2D6AFF)](https://memex.stifler.in)
18
+ [![PyPI](https://img.shields.io/pypi/v/memex-mcp?v=1.0.0)](https://pypi.org/project/memex-mcp/)
16
19
  [![PyPI downloads](https://img.shields.io/pypi/dm/memex-mcp)](https://pypistats.org/packages/memex-mcp)
17
- [![npm](https://img.shields.io/npm/v/stifler-memex-mcp?v=0.9.0)](https://www.npmjs.com/package/stifler-memex-mcp)
20
+ [![npm](https://img.shields.io/npm/v/stifler-memex-mcp?v=1.0.0)](https://www.npmjs.com/package/stifler-memex-mcp)
18
21
  [![npm downloads](https://img.shields.io/npm/dm/stifler-memex-mcp)](https://www.npmjs.com/package/stifler-memex-mcp)
19
22
  [![Claude Code marketplace](https://img.shields.io/badge/Claude%20Code-marketplace-7c3aed)](https://github.com/STiFLeR7/claude-plugins)
20
23
  [![memex MCP server](https://glama.ai/mcp/servers/STiFLeR7/memex/badges/score.svg)](https://glama.ai/mcp/servers/STiFLeR7/memex)
@@ -24,7 +27,27 @@ personal memory or raw session state.
24
27
  [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/STiFLeR7/memex/badge)](https://securityscorecards.dev/viewer/?uri=github.com/STiFLeR7/memex)
25
28
  [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
26
29
 
27
- ![memex — temporal knowledge graph MCP server for AI coding agents, built on Graphiti and Neo4j](https://raw.githubusercontent.com/STiFLeR7/memex/master/assets/memex.png)
30
+ [![Memex on AI Agents Listing](https://aiagentslisting.com/memex/badge.svg?claim=1af930b83c7adc182c0f2c52cb300afb)](https://aiagentslisting.com/mcp/memex)
31
+
32
+ ## Where memex lives
33
+
34
+ | | |
35
+ |---|---|
36
+ | Website | [memex.stifler.in](https://memex.stifler.in) |
37
+ | Source | [github.com/STiFLeR7/memex](https://github.com/STiFLeR7/memex) |
38
+ | Python package | [`memex-mcp` on PyPI](https://pypi.org/project/memex-mcp/) |
39
+ | Node package | [`stifler-memex-mcp` on npm](https://www.npmjs.com/package/stifler-memex-mcp) |
40
+ | MCP Registry | [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io/), listed as `io.github.STiFLeR7/memex` |
41
+ | Claude Code plugin | [STiFLeR7/claude-plugins](https://github.com/STiFLeR7/claude-plugins) |
42
+ | Directories | [Glama](https://glama.ai/mcp/servers/STiFLeR7/memex) · [AI Agents Listing](https://aiagentslisting.com/mcp/memex) |
43
+
44
+ Evaluation record in [BENCHMARK.md](BENCHMARK.md), release history in
45
+ [CHANGELOG.md](CHANGELOG.md), reporting process in [SECURITY.md](SECURITY.md),
46
+ and how to work on it in [CONTRIBUTING.md](CONTRIBUTING.md).
47
+
48
+ [![Watch memex v1 in 60 seconds: how memex keeps Claude Code and Codex sessions current as the code changes](https://raw.githubusercontent.com/STiFLeR7/memex/master/assets/memex-v1-video.jpg?v=1.0.0)](https://raw.githubusercontent.com/STiFLeR7/memex/master/assets/memex-v1.mp4)
49
+
50
+ ▶ **[Watch memex v1 in 60 seconds](https://raw.githubusercontent.com/STiFLeR7/memex/master/assets/memex-v1.mp4)**
28
51
 
29
52
  ```mermaid
30
53
  flowchart LR
@@ -117,7 +140,7 @@ initial admin key, and the `down -v` footgun to avoid.
117
140
  | Property | Value |
118
141
  |---|---|
119
142
  | Output | A Neo4j graph populated continuously from your repo |
120
- | Storage | Neo4j via [Graphiti](https://github.com/getzep/graphiti). Bitemporal — every edge has `created_at` and optional `expired_at` |
143
+ | Storage | Neo4j via [Graphiti](https://github.com/getzep/graphiti). Bitemporal: every edge has `created_at` and optional `expired_at` |
121
144
  | Context | Bounded, ranked, provenance-aware `ContextPacket` |
122
145
  | Integrations | Hermes MemoryProvider, MCP resources/tools, Claude Code, Cursor, Codex, Gemini CLI |
123
146
  | Failure mode | Fail-open; agent execution continues without memex |
@@ -152,7 +175,7 @@ flowchart TD
152
175
 
153
176
  ## MCP tools
154
177
 
155
- 14 tools — eight read, four write, two analytic.
178
+ 14 tools: eight read, four write, two analytic.
156
179
 
157
180
  ### Read
158
181
 
@@ -219,7 +242,7 @@ flowchart LR
219
242
  | Algorithm | `graspologic.partition.hierarchical_leiden` with fixed seed |
220
243
  | Naming | TF-IDF top-3 over module docstrings + symbol names, parent-dir fallback |
221
244
  | ID pinning | Jaccard ≥ 0.5 across reruns (cluster names stay stable through renames) |
222
- | User overrides | `.memex/clusters.yaml` — any assignment can be locked |
245
+ | User overrides | `.memex/clusters.yaml`, where any assignment can be locked |
223
246
  | Context budget | `get_project_context` stays under 1500 tokens whether your repo has 50 or 5000 modules |
224
247
 
225
248
  ## Measure Your Savings
@@ -322,7 +345,7 @@ args = ["-y", "stifler-memex-mcp", "serve", "--repo", "."]
322
345
  <details>
323
346
  <summary><b>Anthropic memory tool (memory_20250818)</b></summary>
324
347
 
325
- memex can back Claude's native memory tool — agents read from a per-session graph projection plus a writable scratch zone.
348
+ memex can back Claude's native memory tool: agents read from a per-session graph projection plus a writable scratch zone.
326
349
 
327
350
  ```bash
328
351
  memex memory-tool serve --repo . # in-process
@@ -402,8 +425,8 @@ Hill Patel ([@STiFLeR7](https://github.com/STiFLeR7))
402
425
 
403
426
  ## Core Contributors & Maintainers
404
427
 
405
- - Hill Patel ([@STiFLeR7](https://github.com/STiFLeR7)) — architect, maintainer
406
- - Nirvaan Lagishetty ([@Nirvaan05](https://github.com/Nirvaan05)) — lead contributor, maintainer
428
+ - Hill Patel ([@STiFLeR7](https://github.com/STiFLeR7)), architect and maintainer
429
+ - Nirvaan Lagishetty ([@Nirvaan05](https://github.com/Nirvaan05)), lead contributor and maintainer
407
430
 
408
431
  ## Contributing
409
432
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "stifler-memex-mcp",
3
- "version": "0.9.0",
3
+ "version": "1.0.0",
4
4
  "mcpName": "io.github.STiFLeR7/memex",
5
5
  "description": "Trusted engineering context for agentic software engineering via Hermes MemoryProvider and MCP.",
6
6
  "bin": {