9e6cf3b830
README is now just an overview with links. Component docs: - docs/memory.md: store design, algorithms, config, CLI reference - docs/hooks.md: Claude Code integration setup - docs/daemon.md, docs/notifications.md: from previous commit
33 lines
1.7 KiB
Markdown
33 lines
1.7 KiB
Markdown
# poc-memory
|
|
|
|
A persistent memory and notification system for AI assistants,
|
|
modelled after the human hippocampus. Combines episodic memory
|
|
(timestamped journal of experiences) with an associative knowledge
|
|
graph (weighted nodes connected by typed relations), and layered
|
|
background processes that maintain graph health — mirroring how
|
|
biological memory consolidates during rest.
|
|
|
|
## Components
|
|
|
|
| Component | What it does | Docs |
|
|
|-----------|-------------|------|
|
|
| **Memory store** | Knowledge graph with episodic journal, TF-IDF search, spectral embedding, weight decay | [docs/memory.md](docs/memory.md) |
|
|
| **Memory daemon** | Background pipeline: experience-mine, fact-mine, consolidation | [docs/daemon.md](docs/daemon.md) |
|
|
| **Notification daemon** | Activity-aware message routing from IRC and Telegram | [docs/notifications.md](docs/notifications.md) |
|
|
| **Hooks** | Claude Code integration: memory recall and notification delivery | [docs/hooks.md](docs/hooks.md) |
|
|
|
|
## Quick start
|
|
|
|
```bash
|
|
cargo install --path . # Builds: poc-memory, memory-search, poc-daemon, poc-hook
|
|
poc-memory init # Initialize the store
|
|
poc-memory daemon install # Install systemd service + hooks
|
|
```
|
|
|
|
## For AI assistants
|
|
|
|
- **Search before creating**: `poc-memory search` before writing new nodes
|
|
- **Close the feedback loop**: `poc-memory used KEY` / `poc-memory wrong KEY`
|
|
- **Journal is the river, topic nodes are the delta**: write experiences to the journal, pull themes into topic nodes during consolidation
|
|
- **Notifications flow automatically**: IRC/Telegram messages arrive as additionalContext
|
|
- **Use daemon commands directly**: `poc-daemon irc send #channel msg`, `poc-daemon telegram send msg`
|