---

name: (24 words max) Human-readable pack name

name: Madeinoz Knowledge System

pack-id: (format) {author}-{pack-name}-{variant}-v{version}

pack-id: madeinoz67-madeinoz-knowledge-system-core-v1.9.0

version: (format) SemVer major.minor.patch

version: 1.9.0

author: (1 word) GitHub username or organization

author: madeinoz67

description: (128 words max) One-line description

description: Persistent personal knowledge management system powered by Graphiti knowledge graph with FalkorDB or Neo4j backend - automatic entity extraction, relationship mapping, and semantic search for AI conversations and documents

type: (single) concept | skill | hook | plugin | agent | mcp | workflow | template | other

type: skill

purpose-type: (multi) security | productivity | research | development | automation | integration | creativity | analysis | other

purpose-type: [productivity, automation, development]

platform: (single) agnostic | claude-code | opencode | cursor | custom

platform: claude-code

dependencies: (list) Required pack-ids, empty [] if none

dependencies: []

keywords: (24 tags max) Searchable tags for discovery

keywords: [knowledge, graph, memory, semantic search, entity extraction, relationships, graphiti, falkordb, neo4j, mcp, persistent, ai, storage, retrieval, organizational, learning, documentation]

Knowledge

Persistent personal knowledge management system powered by Graphiti knowledge graph - automatically extracts entities, relationships, and temporal context from conversations and documents.

CI CodeQL GitHub release (latest by date) GitHub Container Registry

Changelog

See CHANGELOG.md for full version history.

Documentation

View Full Documentation - Complete guides, architecture, and reference.

Topic	Description
Getting Started	Installation and quick start guide
Configuration	Environment variables and settings
Architecture	System design and components
Troubleshooting	Common issues and solutions
Developer Notes	Contributing and development

Installation

See INSTALL.md for complete installation instructions, performance benchmarks, and VERIFY.md for verification checklist.

Features

• Automatic Entity Extraction - LLM-powered extraction of people, organizations, concepts, and more
• Relationship Mapping - Automatically discovers connections between entities
• Semantic Search - Find knowledge using natural language, not just keywords
• Investigative Search - Find entity with all connected relationships in a single query (configurable depth 1-3 hops)
• Memory Decay Scoring - Automatic memory prioritization with importance/stability classification
• Weighted Search - Results ranked by semantic relevance, recency, and importance
• Lifecycle Management - Automated memory transitions (ACTIVE → DORMANT → ARCHIVED → EXPIRED)
• Prometheus Metrics - Token usage, API costs, cache statistics, and memory health metrics
• Automated Maintenance - Scheduled cleanup of expired memories
• Grafana Dashboards - Visualize knowledge, token usage, graph stats and memory health
• Temporal Tracking - Know when knowledge was captured and how it evolves
• Memory Sync - Auto-syncs learnings from PAI Memory System
• OSINT/CTI Ontology - Custom entity types for threat intelligence (ThreatActor, Malware, Vulnerability, Indicator, etc.) with STIX 2.1 import support

Usage

The skill triggers automatically based on natural language:

Say This	Action
"remember that X"	Capture knowledge with entity extraction
"what do I know about X"	Semantic search for related entities
"how are X and Y related"	Find relationships between concepts
"what did I learn today"	Temporal search - filter by date
"recent learnings"	Retrieve recent knowledge additions
"knowledge status"	Check system health

Temporal Search

Filter search results by date with --since and --until:

# Today's knowledge
bun run tools/knowledge-cli.ts search_nodes "topic" --since today

# Last 7 days
bun run tools/knowledge-cli.ts search_facts "decisions" --since 7d

# Date range
bun run tools/knowledge-cli.ts search_nodes "project" --since 2026-01-01 --until 2026-01-15

Date formats: today, yesterday, 7d, 1w, 1m, or ISO dates (2026-01-26)

Weighted Search (Low-Cost)

Rank results by semantic relevance (60%) + recency (25%) + importance (15%) using the --weighted flag:

# Weighted search - prioritizes important, recent, relevant knowledge
bun run tools/knowledge-cli.ts search_nodes "topic" --weighted

Cost benefit: Weighted scoring uses already-computed embeddings and metadata — no additional LLM calls. Works with any embedding model including free/local options like Ollama, Trinity, or gpt-4o-mini.

Output includes:

• 📊 Overall score (0-1)
• S: Semantic similarity
• R: Recency score
• I: Importance score
• Lifecycle state (ACTIVE/DORMANT/ARCHIVED)
• Importance/Stability ratings (1-5)

What's Included

Component	Purpose
SKILL.md	PAI skill with intent-based routing
src/skills/workflows/	8 workflows (Capture, Search, SearchByDate, Facts, Recent, Status, Clear, BulkImport)
src/skills/tools/	Server management scripts (start, stop, status, logs)
src/hooks/	Memory sync hook for automatic knowledge capture
docker/	Docker/Podman compose files for Neo4j and FalkorDB

Database Backends

Backend	Web UI	Best For
Neo4j (default and recommended)	http://localhost:7474	Rich queries, special character handling
FalkorDB (experimental)	http://localhost:3000	Simple setup, lower resources

For AI Agents

This is a PAI Pack - a complete, self-contained module for Personal AI Infrastructure:

1. Read the entire README to understand what you're installing
2. Follow INSTALL.md step-by-step
3. Complete ALL verification checks in VERIFY.md
4. If any step fails, STOP and troubleshoot before continuing

Credits

• Knowledge graph engine: Graphiti by Zep AI
• Graph databases: Neo4j, FalkorDB
• Built for: Personal AI Infrastructure (PAI)

See full Acknowledgments for credits to the community and research that inspired this system.

Related

• PAI Memory System - Auto-syncs learnings to knowledge graph
• PAI Research Skill - Capture research findings

---

For detailed documentation, visit the full docs.