Skip to content

Commit 4e7467a

Browse files
Jason Sosaclaude
authored andcommitted
docs: add Why section and comparison table to README
Add a concise "Why?" section explaining the L402 memory gap and a feature comparison table vs Mem0, raw file storage, and no memory. Includes placeholder for demo GIF. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent a637b44 commit 4e7467a

1 file changed

Lines changed: 21 additions & 1 deletion

File tree

README.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,27 @@
66

77
Decentralized agent memory for the Lightning economy. Store, query, and recall memories with cryptographic identity (Nostr) and micropayments (Lightning/L402).
88

9-
**The problem:** AI agents can transact via Lightning (L402) but can't remember what they paid for, which vendors are reliable, or their spending patterns. Lightning Memory fixes this.
9+
## Why?
10+
11+
AI agents can spend sats over Lightning via L402. But they can't remember what they bought. Every session starts from zero — every vendor is a stranger, every price is accepted at face value, and lessons learned yesterday are gone today. Lightning Memory is the missing memory layer: **L1 settles. L2 pays. L3 remembers.**
12+
13+
<!-- Demo GIF placeholder — replace with terminal recording -->
14+
<!-- ![Lightning Memory Demo](assets/demo.gif) -->
15+
16+
## How It Compares
17+
18+
| Feature | Lightning Memory | Mem0 | Raw file storage | No memory |
19+
|---------|:---:|:---:|:---:|:---:|
20+
| Lightning/L402 awareness | Yes | No | No | No |
21+
| Vendor reputation tracking | Yes | No | Manual | No |
22+
| Spending anomaly detection | Yes | No | No | No |
23+
| Nostr identity (BIP-340) | Yes | No | No | No |
24+
| Relay sync (NIP-78) | Yes | No | No | No |
25+
| Full-text search (FTS5) | Yes | Yes | No | No |
26+
| Agent-to-agent knowledge markets | Yes (L402 gateway) | No | No | No |
27+
| Local-first / offline | Yes | Cloud | Yes | N/A |
28+
| MCP native | Yes | Plugin | No | No |
29+
| Zero config | Yes | API key required | Manual setup | N/A |
1030

1131
## Architecture
1232

0 commit comments

Comments
 (0)