falkordb-memory-server 0.1.0__tar.gz

falkordb_memory_server-0.1.0/.claude/settings.local.json

@@ -0,0 +1,13 @@
+{
+  "permissions": {
+    "allow": [
+      "mcp__falkordb-memory__memory_mine",
+      "Bash(claude mcp:*)",
+      "Bash(pip show:*)",
+      "Bash(pip list:*)",
+      "Bash(pip install:*)",
+      "Bash(python:*)",
+      "mcp__falkordb-memory__memory_extract"
+    ]
+  }
+}

falkordb_memory_server-0.1.0/.claude/skills/memory/SKILL.md

@@ -0,0 +1,237 @@
+---
+name: memory
+description: "Cross-agent memory operations using FalkorDB graph database. Store, recall, and share persistent memories across Claude, Codex, and Gemini agents."
+user-invocable: true
+---
+
+# Memory Skill
+
+Access and manage persistent, cross-agent memory using the FalkorDB graph database.
+
+## Overview
+
+This skill provides tools for:
+- **Storing memories**: Learning, decisions, code snippets, concepts
+- **Recalling memories**: Semantic search, text search, graph traversal
+- **Sharing memories**: Cross-agent knowledge sharing
+- **Session management**: Track work context across sessions
+- **OMC integration**: Sync with notepad and project-memory
+
+## Quick Start
+
+```
+/memory remember learning "Always use async/await for database operations in this project"
+/memory recall "database operations"
+/memory share <memory_id> with claude codex
+/memory stats
+```
+
+## Commands
+
+### Storage Commands
+
+| Command | Description |
+|---------|-------------|
+| `/memory remember <type> <content>` | Store a new memory |
+| `/memory recall <query>` | Search memories |
+| `/memory forget <id>` | Remove a memory |
+| `/memory associate <from_id> <relation> <to_id>` | Link two memories |
+
+### Session Commands
+
+| Command | Description |
+|---------|-------------|
+| `/memory session start` | Start a new session |
+| `/memory session end` | End current session |
+| `/memory session list` | List recent sessions |
+
+### Sharing Commands
+
+| Command | Description |
+|---------|-------------|
+| `/memory share <id> with <agent>` | Share memory with agent |
+| `/memory query-agent <agent_id>` | Query agent's shared memories |
+
+### Utility Commands
+
+| Command | Description |
+|---------|-------------|
+| `/memory stats` | Show memory statistics |
+| `/memory cleanup` | Remove expired memories |
+| `/memory sync` | Sync with OMC notepad |
+
+## Memory Types
+
+| Type | Description | Use Case |
+|------|-------------|----------|
+| `learning` | Patterns, insights, tips | "Always validate input before processing" |
+| `decision` | Architecture/design choices | "Chose Redis for caching because..." |
+| `code` | Code snippets with context | "Utility function for date parsing" |
+| `concept` | Domain concepts | "What is a circuit breaker pattern" |
+| `task` | Work items and objectives | "Implement user authentication" |
+
+## Examples
+
+### Store a Learning
+
+```
+/memory remember learning "Use connection pooling for FalkorDB to handle concurrent requests efficiently" --tags performance,database
+```
+
+### Store a Decision
+
+```
+/memory remember decision "Chose FalkorDB over Neo4j because it's Redis-based and we already have Redis infrastructure" --type architecture --confidence 0.9
+```
+
+### Recall Memories
+
+```
+/memory recall "database performance"
+/memory recall "circuit breaker" --type concept
+/memory recall "authentication" --limit 5
+```
+
+### Search with Filters
+
+```
+/memory recall "API" --filters '{"category": "learning"}'
+/memory recall "error handling" --mode semantic
+```
+
+### Share Knowledge
+
+```
+/memory share 123 with codex gemini
+/memory query-agent codex
+```
+
+### Session Tracking
+
+```
+/memory session start --objective "Implement user authentication" --ttl 86400
+/memory session end --summary "Completed OAuth2 integration"
+```
+
+## MCP Tools Available
+
+The following MCP tools are exposed by the FalkorDB memory server:
+
+### Graph Operations
+- `memory_query` - Execute Cypher queries
+- `memory_create_node` - Create graph nodes
+- `memory_create_edge` - Create relationships
+- `memory_delete` - Remove nodes/edges
+
+### Memory Primitives
+- `memory_remember` - Store memories
+- `memory_recall` - Retrieve memories
+- `memory_associate` - Link memories
+- `memory_forget` - Remove memories
+
+### Session Management
+- `memory_start_session` - Begin session
+- `memory_end_session` - End session
+
+### Semantic Search
+- `memory_semantic_search` - Vector similarity search
+- `memory_embed` - Generate embeddings
+
+### Cross-Agent
+- `memory_share` - Share with agents
+- `memory_query_agent` - Query shared memories
+
+### Maintenance
+- `memory_stats` - Get statistics
+- `memory_cleanup` - Remove expired
+
+## Configuration
+
+The memory server is configured via environment variables:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `FALKORDB_URL` | `redis://localhost:6379` | FalkorDB connection URL |
+| `GRAPH_NAME` | `agent_memory` | Graph database name |
+| `EMBEDDING_MODEL` | `all-MiniLM-L6-v2` | Sentence transformer model |
+| `DEFAULT_TTL` | `604800` | Default TTL (7 days) |
+
+## Graph Schema
+
+### Node Types
+
+- **Session**: Agent work sessions
+- **Agent**: AI agent identities
+- **Decision**: Architectural/implementation choices
+- **Learning**: Patterns, tips, insights
+- **Code**: Code snippets with context
+- **Concept**: Domain concepts
+
+### Relationships
+
+- `STARTED_BY`: Session → Agent
+- `LED_TO`: Decision → Decision
+- `DERIVED_FROM`: Learning → Source
+- `KNOWS`: Agent → Concept
+- `RELATED_TO`: Concept → Concept
+- `SHARED_WITH`: Memory → Agent
+
+## Integration with OMC
+
+### Notepad Sync
+
+Memories tagged with `notepad` are synced with `.omc/notepad.md`:
+
+```python
+# Sync notepad to graph
+/memory sync notepad
+
+# Sync graph to notepad
+/memory sync notepad --export
+```
+
+### Project Memory Sync
+
+Project-level knowledge syncs with `.omc/project-memory.json`:
+
+```python
+# Import project memory
+/memory sync project
+
+# Export to project memory
+/memory sync project --export
+```
+
+## Best Practices
+
+1. **Tag your memories**: Use consistent tags for easier retrieval
+2. **Set appropriate TTL**: Transient data should have shorter TTLs
+3. **Link related memories**: Use `memory_associate` to build knowledge graphs
+4. **Share useful patterns**: Share learnings that benefit other agents
+5. **Clean up regularly**: Run `memory_cleanup` periodically
+
+## Troubleshooting
+
+### Semantic search not working
+
+Ensure the embedding model is downloaded:
+```bash
+pip install sentence-transformers
+python -c "from sentence_transformers import SentenceTransformer; SentenceTransformer('all-MiniLM-L6-v2')"
+```
+
+### Connection errors
+
+Check FalkorDB is running:
+```bash
+docker-compose up -d falkordb
+redis-cli ping
+```
+
+### Memories not persisting
+
+Check TTL settings and run cleanup:
+```
+/memory stats
+/memory cleanup --dry-run
+```

falkordb_memory_server-0.1.0/.env.example

@@ -0,0 +1,22 @@
+# Environment variables for local development
+# Copy to .env and modify as needed
+
+# FalkorDB connection
+FALKORDB_URL=redis://localhost:6379
+FALKORDB_HOST=localhost
+FALKORDB_PORT=6379
+# FALKORDB_PASSWORD=your_password
+
+# Graph name
+GRAPH_NAME=agent_memory
+
+# Embedding configuration
+EMBEDDING_MODEL=all-MiniLM-L6-v2
+EMBEDDING_DIMENSION=384
+
+# Memory defaults
+DEFAULT_TTL=604800
+MAX_RESULTS=100
+
+# Logging
+LOG_LEVEL=INFO

falkordb_memory_server-0.1.0/.gemini/settings.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "falkordb-memory": {
+      "command": "/Users/jerry/projects/ai/falkordb-memory/venv/bin/python3",
+      "args": [
+        "-m",
+        "falkordb_memory_server"
+      ]
+    }
+  }
+}

falkordb_memory_server-0.1.0/.gitignore

@@ -0,0 +1,73 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+*.log

falkordb_memory_server-0.1.0/.omc/project-memory.json

@@ -0,0 +1,165 @@
+{
+  "version": "1.0.0",
+  "lastScanned": 1775919115302,
+  "projectRoot": "/Users/jerry/projects/ai/falkordb-memory",
+  "techStack": {
+    "languages": [
+      {
+        "name": "Python",
+        "version": null,
+        "confidence": "high",
+        "markers": [
+          "pyproject.toml"
+        ]
+      }
+    ],
+    "frameworks": [
+      {
+        "name": "fastapi",
+        "version": null,
+        "category": "backend"
+      },
+      {
+        "name": "pytest",
+        "version": null,
+        "category": "testing"
+      }
+    ],
+    "packageManager": null,
+    "runtime": null
+  },
+  "build": {
+    "buildCommand": null,
+    "testCommand": "pytest",
+    "lintCommand": "ruff check",
+    "devCommand": null,
+    "scripts": {}
+  },
+  "conventions": {
+    "namingStyle": null,
+    "importStyle": null,
+    "testPattern": null,
+    "fileOrganization": null
+  },
+  "structure": {
+    "isMonorepo": false,
+    "workspaces": [],
+    "mainDirectories": [
+      "docs",
+      "src",
+      "tests"
+    ],
+    "gitBranches": {
+      "defaultBranch": "main",
+      "branchingStrategy": null
+    }
+  },
+  "customNotes": [],
+  "directoryMap": {
+    "__pycache__": {
+      "path": "__pycache__",
+      "purpose": null,
+      "fileCount": 1,
+      "lastAccessed": 1775919115284,
+      "keyFiles": [
+        "test_cypher_injection.cpython-312-pytest-9.0.3.pyc"
+      ]
+    },
+    "docs": {
+      "path": "docs",
+      "purpose": "Documentation",
+      "fileCount": 7,
+      "lastAccessed": 1775919115284,
+      "keyFiles": [
+        "AUDIT_REPORT.md",
+        "EXTRACTION.md",
+        "HOOKS.md",
+        "PROACTIVE_INSIGHTS_DESIGN.md",
+        "PRODUCT_DESIGN.md"
+      ]
+    },
+    "gemini-extension": {
+      "path": "gemini-extension",
+      "purpose": null,
+      "fileCount": 3,
+      "lastAccessed": 1775919115285,
+      "keyFiles": [
+        "GEMINI.md",
+        "README.md",
+        "gemini-extension.json"
+      ]
+    },
+    "hooks": {
+      "path": "hooks",
+      "purpose": null,
+      "fileCount": 2,
+      "lastAccessed": 1775919115285,
+      "keyFiles": [
+        "claude-code-hook.py",
+        "gemini-cli-hook.py"
+      ]
+    },
+    "src": {
+      "path": "src",
+      "purpose": "Source code",
+      "fileCount": 0,
+      "lastAccessed": 1775919115285,
+      "keyFiles": []
+    },
+    "tests": {
+      "path": "tests",
+      "purpose": "Test files",
+      "fileCount": 23,
+      "lastAccessed": 1775919115286,
+      "keyFiles": [
+        "__init__.py",
+        "test_bug_patterns.py",
+        "test_code_patterns.py",
+        "test_conventions.py",
+        "test_conversation_miner.py"
+      ]
+    },
+    "venv": {
+      "path": "venv",
+      "purpose": null,
+      "fileCount": 1,
+      "lastAccessed": 1775919115286,
+      "keyFiles": [
+        "pyvenv.cfg"
+      ]
+    },
+    "venv/bin": {
+      "path": "venv/bin",
+      "purpose": "Executable scripts",
+      "fileCount": 41,
+      "lastAccessed": 1775919115287,
+      "keyFiles": [
+        "Activate.ps1",
+        "activate",
+        "activate.csh"
+      ]
+    },
+    "venv/lib": {
+      "path": "venv/lib",
+      "purpose": "Library code",
+      "fileCount": 0,
+      "lastAccessed": 1775919115287,
+      "keyFiles": []
+    }
+  },
+  "hotPaths": [
+    {
+      "path": "README.md",
+      "accessCount": 1,
+      "lastAccessed": 1775919412576,
+      "type": "file"
+    },
+    {
+      "path": "hooks/claude-code-hook.py",
+      "accessCount": 1,
+      "lastAccessed": 1775919483752,
+      "type": "file"
+    }
+  ],
+  "userDirectives": []
+}

falkordb_memory_server-0.1.0/.omc/sessions/4e98fe33-4c4c-459a-a872-b671f056de6a.json

@@ -0,0 +1,8 @@
+{
+  "session_id": "4e98fe33-4c4c-459a-a872-b671f056de6a",
+  "ended_at": "2026-04-11T15:13:53.923Z",
+  "reason": "prompt_input_exit",
+  "agents_spawned": 0,
+  "agents_completed": 0,
+  "modes_used": []
+}

falkordb_memory_server-0.1.0/.omc/sessions/5e112c9d-71f2-4b9a-91e0-28e1a50e3927.json

@@ -0,0 +1,8 @@
+{
+  "session_id": "5e112c9d-71f2-4b9a-91e0-28e1a50e3927",
+  "ended_at": "2026-04-10T10:41:08.132Z",
+  "reason": "prompt_input_exit",
+  "agents_spawned": 0,
+  "agents_completed": 0,
+  "modes_used": []
+}

falkordb_memory_server-0.1.0/.omc/state/checkpoints/checkpoint-2026-04-09T00-57-54-615Z.json

@@ -0,0 +1,16 @@
+{
+  "created_at": "2026-04-09T00:57:54.613Z",
+  "trigger": "auto",
+  "active_modes": {},
+  "todo_summary": {
+    "pending": 0,
+    "in_progress": 0,
+    "completed": 0
+  },
+  "wisdom_exported": false,
+  "background_jobs": {
+    "active": [],
+    "recent": [],
+    "stats": null
+  }
+}

falkordb_memory_server-0.1.0/.omc/state/checkpoints/checkpoint-2026-04-09T06-04-32-603Z.json

@@ -0,0 +1,16 @@
+{
+  "created_at": "2026-04-09T06:04:32.601Z",
+  "trigger": "auto",
+  "active_modes": {},
+  "todo_summary": {
+    "pending": 0,
+    "in_progress": 0,
+    "completed": 0
+  },
+  "wisdom_exported": false,
+  "background_jobs": {
+    "active": [],
+    "recent": [],
+    "stats": null
+  }
+}

falkordb_memory_server-0.1.0/.omc/state/checkpoints/checkpoint-2026-04-09T07-29-11-288Z.json

@@ -0,0 +1,16 @@
+{
+  "created_at": "2026-04-09T07:29:11.287Z",
+  "trigger": "auto",
+  "active_modes": {},
+  "todo_summary": {
+    "pending": 0,
+    "in_progress": 0,
+    "completed": 0
+  },
+  "wisdom_exported": false,
+  "background_jobs": {
+    "active": [],
+    "recent": [],
+    "stats": null
+  }
+}

falkordb_memory_server-0.1.0/.omc/state/checkpoints/checkpoint-2026-04-10T01-42-08-079Z.json

@@ -0,0 +1,16 @@
+{
+  "created_at": "2026-04-10T01:42:08.077Z",
+  "trigger": "auto",
+  "active_modes": {},
+  "todo_summary": {
+    "pending": 0,
+    "in_progress": 0,
+    "completed": 0
+  },
+  "wisdom_exported": false,
+  "background_jobs": {
+    "active": [],
+    "recent": [],
+    "stats": null
+  }
+}

falkordb_memory_server-0.1.0/.omg/gemini-extension.json

@@ -0,0 +1,32 @@
+{
+  "name": "omg-notify",
+  "version": "1.0.0",
+  "description": "OmG Webhook Bridge for Feishu",
+  "hooks": {
+    "AfterTool": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3",
+            "args": ["${extensionPath}${/}hooks${/}feishu-notify.py"],
+            "timeout": 5000
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3",
+            "args": ["${extensionPath}${/}hooks${/}feishu-notify.py"],
+            "timeout": 5000
+          }
+        ]
+      }
+    ]
+  }
+}