---

😤 Problem

You: remember that API design we discussed last week?
AI:  I don't have access to previous conversations. Could you remind me?

You: ...we literally spent 2 hours on it
AI:  I apologize, but each conversation starts fresh. I don't retain memory.

You: *dies inside*

Claude Code is stateless. Every session starts from zero. No memory of past conversations, no reflection on what worked, no creative connections across contexts.

---

✨ Solution

six6 gives Claude Code a cognitive loop:

Module	What it does	When
Memory	Graphiti knowledge graph, persists across sessions	Always on
Meditation	Daily reflection, compresses experiences into insights	2:30 AM
Daydream	Random memory sampling, sparks unexpected connections	5:00 PM
Hooks	Auto memory recall on every prompt, zero manual work	Every message

Your AI assistant becomes a thinking partner that grows with you.

---

🚀 Quick Start

Local Mode (Mac, 5 min)

# 1. Clone
git clone https://github.com/ythx-101/six6-claude-code.git
cd six6-claude-code

# 2. Start Graphiti (needs OpenAI key for embeddings)
export OPENAI_API_KEY="sk-..."
docker compose up -d

# 3. Install hooks
mkdir -p ~/.claude/hooks
cp hooks/*.py ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.py

# 4. Add to ~/.claude.json

{
  "mcpServers": {
    "six6-memory": {
      "type": "http",
      "url": "http://localhost:8000/mcp"
    }
  }
}

# 5. Add hooks to ~/.claude/settings.json (see config/settings.example.json)

# Done. Start Claude Code.

VPS Mode (for cloud tasks)

See docs/memory-setup.md for remote deployment.

Mode	Graphiti runs on	Cloud /schedule	Multi-device
Local	Your Mac	❌	❌
VPS	Remote server	✅	✅

---

🎯 Features

Memory System

Every conversation gets indexed into a knowledge graph:

You: We decided to use PostgreSQL instead of MongoDB for the user service
     ↓ auto-saved to Graphiti
     ↓ recalled next time you mention "user service" or "database"

Memory groups:

• raw — daily conversations, observations
• reflection — meditation outputs, insights
• topic_lab — creative seeds from daydreams
• soul — core beliefs, principles (rarely changes)

Meditation (2:30 AM)

Nightly reflection that:

1. Searches today's memories
2. Writes 300-500 word reflection
3. Identifies cognitive changes
4. Saves to reflection group

Runs on Claude's cloud even when Mac sleeps.

Daydream (5:00 PM)

Creative exploration that:

1. Randomly samples 5-8 memories across groups
2. Finds unexpected connections
3. Generates idea seeds
4. Saves to topic_lab group

"What if the database migration pattern we discussed connects to that distributed systems paper?"

Hooks

Hook	Trigger	Action
memory-recall.py	Every user message	Search & inject relevant memories
stop-memory-check.py	Session end	Remind to save important insights
post-memory-add.py	Memory write	Log to ~/.claude/memory-log.jsonl

---

🏗 Architecture

┌─────────────────────────────────────────────────────────────┐
│                        Your Mac                              │
│  ┌─────────────┐    ┌─────────────┐    ┌─────────────────┐  │
│  │ Claude Code │───▶│   Hooks     │───▶│ Graphiti (MCP)  │  │
│  │   (CLI)     │◀───│ recall/save │◀───│ localhost:8000  │  │
│  └─────────────┘    └─────────────┘    └────────┬────────┘  │
└─────────────────────────────────────────────────┼───────────┘
                                                  │
                    ┌─────────────────────────────┼───────────┐
                    │            VPS (optional)   │           │
                    │  ┌─────────────────────────▼────────┐   │
                    │  │     Graphiti + FalkorDB          │   │
                    │  │     (persistent storage)         │   │
                    │  └─────────────────────────▲────────┘   │
                    │                            │            │
                    │  ┌─────────────────────────┴────────┐   │
                    │  │   Cloud /schedule tasks          │   │
                    │  │   (meditation, daydream)         │   │
                    │  └──────────────────────────────────┘   │
                    └─────────────────────────────────────────┘

---

⚙️ Configuration

Files

~/.claude/
├── hooks/
│   ├── memory-recall.py      # UserPromptSubmit hook
│   ├── stop-memory-check.py  # Stop hook
│   └── post-memory-add.py    # PostToolUse hook
├── settings.json             # Hook configuration
├── loop.md                   # /loop behavior (optional)
└── ...

~/.claude.json                # MCP server configuration

Environment Variables

Variable	Default	Description
SIX6_MCP_URL	http://localhost:8000/mcp	Graphiti endpoint
SIX6_BEARER_TOKEN	(none)	Auth token for remote Graphiti
SIX6_RECALL_TOP_K	5	Number of memories to recall
SIX6_MEMORY_LOG	~/.claude/memory-log.jsonl	Memory write log

---

☁️ Cloud Tasks

Use Claude's /schedule to run meditation and daydream without your Mac:

# In Claude Code
/schedule

# Create task:
# - Name: daily-meditation
# - Schedule: Daily at 2:30 AM
# - Prompt: (see prompts/meditation.md)
# - Connector: six6-memory

See docs/cloud-tasks.md for detailed setup.

---

📁 Project Structure

six6-claude-code/
├── docker-compose.yml      # Local Graphiti deployment
├── config/
│   ├── loop.md             # /loop cognitive cycle
│   ├── settings.example.json
│   └── claude.example.json
├── hooks/
│   ├── memory-recall.py
│   ├── stop-memory-check.py
│   └── post-memory-add.py
├── prompts/
│   ├── meditation.md
│   └── daydream.md
└── docs/
    ├── architecture.md
    ├── memory-setup.md
    └── cloud-tasks.md

---

🤝 Credits

Built by Lin Yue & Xiao Ling 🦞

Inspired by the belief that AI assistants should grow with their users, not start from zero every time.

---

📄 License

MIT