What does the Session Memory skill do?

It allows Claude Code to remember context, instincts, and project-specific identity between different work sessions, creating a sense of continuity.

Where is the session data stored?

All observations, identity data, and instincts are stored locally within your project's .claude/homunculus directory.

How does the background observer work?

Upon starting a session, it spawns a lightweight Claude 3 Haiku subagent to process pending observations without interrupting your primary coding workflow.

What are 'instincts' in the Homunculus plugin?

Instincts are learned preferences and behavioral patterns that the system gathers over time to tailor Claude's suggestions to your specific working style.

How do I know when the skill has learned something new?

The skill will provide a notification during its startup greeting when it has clustered enough data to run the /homunculus:evolve command.

Session Memory

Name: Session Memory
Author: humanplane

byhumanplane

•

209

•

Productivity & Workflow

Maintains persistent awareness across development sessions by tracking project identity, learned instincts, and work patterns.

Session Memory is a specialized capability for the Homunculus plugin that enables Claude Code to bridge the context gap between separate work sessions. It works by spawning a background observer agent to process past interactions, loading project-specific 'instincts,' and tracking evolution opportunities based on your unique coding style. By maintaining a continuous thread of identity and progress, this skill ensures that Claude recognizes your patterns and remains aligned with your project goals every time you restart your terminal.

Key Features

01Evolution triggers that notify you when enough data exists to refine AI behavior

02Automated session tracking and context-aware greetings

03209 GitHub stars

04Persistent identity loading via localized JSON and instinct files

05Integration with Git logs to summarize recent activity at startup

06Background observer agent for processing work patterns using Claude 3 Haiku

Use Cases

01Maintaining continuity in long-term projects where context usually resets between sessions

02Developing a personalized AI assistant that adapts to your specific coding preferences and team standards

03Streamlining project onboarding by loading pre-defined 'inherited' instincts

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add humanplane/homunculus session-memory

For use in Claude.ai and ChatGPT

Download Skill