How kdbhalala/agi-memory works
agi-memory is an on-device memory system for coding assistants. Assistants connect through the MCP server or lifecycle hooks; they record and retrieve project memories, session history, and code structure across tools. The four memory layers provide working, knowledge-graph, episodic, and structural-code capabilities, with promotion, summaries, import, and recall supporting the day-to-day workflow. The vault and sync modules provide durable, Git-friendly storage and optional cross-device synchronization. Edges reflect README statements and source-index references; unsampled implementation details are not assumed.
Main entry points: mcp_server.py MCP server · session_layer.py Working memory · hooks.py Lifecycle hooks · vault.py Memory vault
Components 21
Assistant interfaces
- MCP server
src/agi_memory/mcp_server.py - Lifecycle hooks
src/agi_memory/hooks.py - Assistant integration
src/agi_memory/integrate.py
Memory layers
- Working memory
src/agi_memory/layers/session_layer.py - Knowledge graph
src/agi_memory/layers/graph_layer.py - Episodic history
src/agi_memory/layers/episodic_layer.py - Code graph
src/agi_memory/layers/code_layer.py - Layer primitives
src/agi_memory/layers/base.py - Recall
src/agi_memory/recall.py - Memory promotion
src/agi_memory/promote.py
History and analysis
- History import
src/agi_memory/history_import.py - Session summaries
src/agi_memory/summarizer.py - Code analysis
src/agi_memory/analyze.py - Credential redaction
src/agi_memory/redact.py
Storage and sync
- Memory vault
src/agi_memory/vault.py - Git synchronization
src/agi_memory/sync.py
Setup and utilities
- Path configuration
src/agi_memory/config.py - Memory bootstrap
src/agi_memory/bootstrap.py - Memory audit
src/agi_memory/audit.py - Interactive dashboard
src/agi_memory/tui.py
Other components
- Coding assistant
Connections 34
- Coding assistant → MCP server: uses tools
README.md - Coding assistant → Lifecycle hooks: triggers events
README.md - Assistant integration → MCP server: configures server
src/agi_memory/integrate.py - Assistant integration → Lifecycle hooks: installs hooks
src/agi_memory/integrate.py - MCP server → Working memory: records and recalls
src/agi_memory/mcp_server.py - MCP server → Knowledge graph: records durable facts
src/agi_memory/mcp_server.py - MCP server → Episodic history: serves timelines
src/agi_memory/mcp_server.py - MCP server → Code graph: serves code queries
src/agi_memory/mcp_server.py - MCP server → Recall: delegates recall
src/agi_memory/mcp_server.py - MCP server → Memory promotion: delegates promotion
src/agi_memory/mcp_server.py - Lifecycle hooks → Episodic history: tracks sessions
src/agi_memory/hooks.py - Lifecycle hooks → Working memory: injects memories
src/agi_memory/hooks.py - Lifecycle hooks → Git synchronization: requests sync
src/agi_memory/hooks.py - History import → Episodic history: imports sessions
src/agi_memory/history_import.py - History import → Credential redaction: redacts imported text
src/agi_memory/history_import.py - History import → Working memory: indexes recent history
README.md - Session summaries → Episodic history: writes rollups
src/agi_memory/summarizer.py - Session summaries → Credential redaction: redacts summaries
src/agi_memory/summarizer.py - Code analysis → Memory bootstrap: uses initialized state
src/agi_memory/analyze.py - Code analysis → Path configuration: resolves settings
src/agi_memory/analyze.py - Working memory → Layer primitives: opens database
src/agi_memory/layers/session_layer.py - Episodic history → Layer primitives: opens database
src/agi_memory/layers/episodic_layer.py - Knowledge graph → Layer primitives: opens database
src/agi_memory/layers/graph_layer.py - Code graph → Layer primitives: opens database
src/agi_memory/layers/code_layer.py - Memory vault → Working memory: exports and imports records
src/agi_memory/vault.py - Memory vault → Knowledge graph: exports and imports graph
src/agi_memory/vault.py - Git synchronization → Memory vault: exports vault data
src/agi_memory/sync.py - Git synchronization → Coding assistant: syncs via Git remote
README.md - Memory bootstrap → Path configuration: resolves paths
src/agi_memory/bootstrap.py - Memory bootstrap → History import: imports history
src/agi_memory/bootstrap.py - Memory audit → Working memory: checks memory records
src/agi_memory/audit.py - Memory audit → Memory vault: checks vault state
src/agi_memory/audit.py - Interactive dashboard → Memory audit: shows audit results
src/agi_memory/tui.py - Interactive dashboard → Memory vault: shows vault data
src/agi_memory/tui.py