Session Memory

This one gives Claude actual continuity between sessions by maintaining identity, instincts, and observations across conversations. On session start, it spawns a background observer agent to process what happened last time, loads your identity and accumulated instincts, and greets you with context about how many sessions you've had together. It'll even notify you when it's clustered enough observations in a domain to evolve new instincts. The whole thing runs on git commits and JSONL files, with hooks handling the observation capture automatically. It's legitimately strange watching an AI maintain preferences that accumulate over time, but if you work with Claude regularly on the same project, this makes it feel less like starting from zero every conversation.

skills.sh installs: 356
GitHub stars: 398
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add humanplane/homunculus --skill session-memory --agent claude-code

Installs into .claude/skills of the current project.

Files

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:

# 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

# 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