Skip to content
This repository was archived by the owner on Sep 23, 2025. It is now read-only.

Commit 697c02b

Browse files
committed
Move Hippo to dedicated repository
- Remove detailed Hippo documentation from Socratic Shell - Replace with high-level overview and redirect to github.com/socratic-shell/hippo - Update SUMMARY.md to reference single overview file - Maintain connection to Socratic Shell collaboration patterns Hippo now has its own focused development space while remaining conceptually connected to the mindful collaboration approach.
1 parent e793bf4 commit 697c02b

File tree

2 files changed

+47
-1
lines changed

2 files changed

+47
-1
lines changed

src/SUMMARY.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@
2626
- [Frequently asked questions](./memory-bank/faq.md)
2727
- [Journal MCP Server](./journal-mcp-server/README.md)
2828
- [Design Document](./journal-mcp-server/design-doc.md)
29-
- [Hippo: AI-Generated Salient Insights](./hippo/README.md)
29+
- [Hippo: AI-Generated Insights Memory System](./hippo.md)
3030

3131
# Dialectic
3232

src/hippo.md

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
# Hippo: AI-Generated Insights Memory System
2+
3+
*An experiment in collaborative memory through reinforcement learning*
4+
5+
## Overview
6+
7+
Hippo is a memory system designed for AI-human collaboration that automatically generates insights during conversations and uses reinforcement learning to surface the most valuable ones over time.
8+
9+
**Core Hypothesis**: AI-generated insights + user reinforcement > manual curation
10+
11+
## Key Innovation
12+
13+
Traditional memory systems require users to manually decide what to remember. Hippo tests whether AI can:
14+
1. **Generate insights automatically** during natural conversation consolidation moments
15+
2. **Learn from usage patterns** to identify which insights are truly valuable
16+
3. **Surface relevant context** at the right moments through semantic search
17+
18+
## How It Works
19+
20+
- **Automatic Generation**: AI creates insights during "Make it so" moments and checkpoints
21+
- **Temporal Decay**: Insights lose relevance over time unless reinforced
22+
- **Reinforcement Learning**: User feedback (upvotes/downvotes) affects future surfacing
23+
- **Context-Aware Search**: Finds insights from similar situations using array-based context matching
24+
- **Hybrid Workflow**: AI suggests reinforcement based on usage patterns, user confirms
25+
26+
## Implementation
27+
28+
Hippo is implemented as an MCP (Model Context Protocol) server providing tools for recording, searching, reinforcing, and modifying insights. It uses importance-weighted scoring with lazy evaluation of temporal decay.
29+
30+
## Status & Repository
31+
32+
Hippo has been spun out into its own dedicated repository for focused development:
33+
34+
**🔗 [github.com/socratic-shell/hippo](https://github.com/socratic-shell/hippo)**
35+
36+
The repository contains:
37+
- Complete technical design and MCP specifications
38+
- LLM usage prompts and integration guidance
39+
- Realistic example dialogs demonstrating the full workflow
40+
- Delegate experiment validating that AI naturally searches memory for technical problems
41+
42+
## Relationship to Socratic Shell
43+
44+
Hippo emerged from exploring memory systems for the Socratic Shell collaboration patterns. While it's now a standalone project, it's designed to integrate seamlessly with the mindful collaboration approach - automatically capturing insights during consolidation moments and surfacing them during future conversations.
45+
46+
The goal is to create a memory system that enhances rather than interrupts the natural flow of collaborative work.

0 commit comments

Comments
 (0)