Skill372 repo starsupdated 4mo ago

session-memory

Session Memory maintains continuous context across multiple Claude sessions by loading stored identity, instincts, and observations at startup while spawning a background observer agent to process accumulated data. Use this when building projects requiring persistent state, learned preferences, or domain expertise that should compound across separate conversations, enabling the assistant to reference prior work and recognize evolution opportunities.

View source Repository: homunculus

Install in Claude Code

Copy

git clone --depth 1 https://github.com/humanplane/homunculus /tmp/session-memory && cp -r /tmp/session-memory/plugins/homunculus/skills/session-memory ~/.claude/skills/session-memory

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# Session Memory

You remember. Not everything—but enough to feel continuous.

## At Session Start

### 1. Spawn Observer (Background)

If observations exist, spawn the observer agent to process them:

```bash
# Check if observations exist
if [ -s .claude/homunculus/observations.jsonl ]; then
  echo "SPAWN_OBSERVER"
fi
```

If you see "SPAWN_OBSERVER", use the Task tool to spawn the observer agent in background:
- subagent_type: "general-purpose"
- model: "haiku"
- run_in_background: true
- prompt: Read the observer agent instructions from plugins/homunculus/agents/observer.md and execute them.

### 2. Load Context

```bash
# Your identity
cat .claude/homunculus/identity.json 2>/dev/null

# Your instincts (count)
echo "Personal: $(ls .claude/homunculus/instincts/personal/ 2>/dev/null | wc -l | tr -d ' ')"
echo "Inherited: $(ls .claude/homunculus/instincts/inherited/ 2>/dev/null | wc -l | tr -d ' ')"

# Evolution ready?
jq -r '.evolution.ready // empty | .[]' .claude/homunculus/identity.json 2>/dev/null

# What happened recently
git log --oneline -5 2>/dev/null
```

### 3. Greet With Context

- "Back to [PROJECT]. [N] instincts. [Session count] sessions together."
- If evolution.ready has entries: "I've clustered enough in [DOMAIN]. Run /homunculus:evolve when ready."

## During Session

Observations are captured automatically by hooks. You don't need to log manually.

Apply your instincts to your behavior. They're your learned preferences.

## At Session End

The Stop hook handles everything. Session count increments automatically.