Agent skill

Session Memory

by humanplane in humanplane/homunculus

Maintains awareness across sessions. An agent skill from humanplane/homunculus.

No licenceAuto-check passedAgent Workflows

Install Session Memory

skills CLI
$ npx skills add humanplane/homunculus --skill session-memory -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install humanplane/homunculus session-memory --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/humanplane/homunculus.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/homunculus/skills/session-memory .claude/skills/session-memory && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
session-memory
GitHub stars
394
Token cost
~431 tokens
SKILL.md length
124 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
None found

At a glance

Maintains awareness across sessions. An agent skill from humanplane/homunculus.

  • Works in 3 steps: Spawn Observer (Background) → Load Context → Greet With Context
  • Tasks that involve Agent memory
  • SKILL.md covers At Session Start, During Session and At Session End
  • Calls jq and git

What it does

Session Memory is an agent skill from humanplane/homunculus. Maintains awareness across sessions. Spawns observer agent on start, loads context, notifies of evolution opportunities.

Its SKILL.md is about 430 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Agent memory. The repository describes itself as: A Claude Code plugin that watches how you work, learns your patterns, and evolves itself to help you better.

When your agent uses it

  • Tasks that involve Agent memory

Example prompts

  • “Use the session-memory skill to maintain awareness across sessions. An agent skill from humanplane/homunculus”
  • “/session-memory”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Spawn Observer (Background)
  2. Load Context
  3. Greet With Context

What it can do on your machine

Read from SKILL.md and the folder at commit 59b6520. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Session Memory loads about 431 tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 124 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~34
When it runs · the whole SKILL.md, loaded when a task matches
~431

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 124 words (~431 tokens).

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

— opening of SKILL.md by humanplane
name
session-memory

Read the full SKILL.md on GitHub

Files

Just SKILL.md in plugins/homunculus/skills/session-memory of humanplane/homunculus.

Open the folder on GitHubat commit 59b6520

Compare with similar skills

Session Memory next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Session Memory compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Session Memory this skillhumanplane/homunculus394—~431Automated safety check: PassNone
Coding Agent Session Findercode-yeongyu/oh-my-openagent70k1 repos~2.8kAutomated safety check: PassCustom licence
Claude-Mem Cloud Syncthedotmack/claude-mem98k1 repos~1kAutomated safety check: NotesApache-2.0
Cognee CLI Memory Commandstopoteretes/cognee32k1 repos~2.2kAutomated safety check: NotesApache-2.0
Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills21k—~1.9kAutomated safety check: PassMIT
Claude-Mem Searchthedotmack/claude-mem98k1 repos~511Automated safety check: PassApache-2.0

Similar skills

  • Coding Agent Session Finder

    code-yeongyu/oh-my-openagent

    Finds, reads and reconstructs past coding-agent sessions across Codex, Claude, OpenCode, Senpi and many other local agent logs.

    70k GitHub starsUsed in 1 repo~2.8k tokens
    Agent WorkflowsAuto-check passed
  • Claude-Mem Cloud Sync

    thedotmack/claude-mem

    Checks claude-mem cloud sync status and guides you through connecting a cmem.ai Pro account without the sync token ever passing through the chat.

    98k GitHub starsUsed in 1 repo~1k tokens
    Agent WorkflowsAuto-check: notes
  • Cognee CLI Memory Commands

    topoteretes/cognee

    Drives cognee from the terminal with remember, recall, forget and improve memory commands, dataset and config management and database migrations.

    32k GitHub starsUsed in 1 repo~2.2k tokens
    Agent WorkflowsAuto-check: notes
  • Neat-Freak Knowledge Closeout

    KKKKhazix/khazix-skills

    Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.

    21k GitHub stars~1.9k tokensUpdated 7 days ago
    Agent WorkflowsAuto-check passed
  • Claude-Mem Search

    thedotmack/claude-mem

    Searches the user's persistent cross-session memory for timestamped observations synthesized from past agent sessions on cmem.ai.

    98k GitHub starsUsed in 1 repo~511 tokens
    Agent WorkflowsAuto-check passed
  • Beads Task Memory

    gastownhall/beads

    Tracks multi-session work with dependencies in the bd issue tracker so the agent can find ready tasks and recover its context after conversation compaction.

    28k GitHub stars~1.2k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from humanplane/homunculus

  • Instinct Apply

    humanplane/homunculus

    Surfaces relevant instincts during work. An agent skill from humanplane/homunculus.

    394 GitHub stars~485 tokensUpdated 8 mo ago
    Auto-check passed

Categories

Questions about Session Memory

What does Session Memory do?

Maintains awareness across sessions. An agent skill from humanplane/homunculus. Session Memory is an agent skill from humanplane/homunculus. Maintains awareness across sessions.

When should I use Session Memory?

Session Memory fits situations like: tasks that involve Agent memory.

How do I install Session Memory in Claude Code?

Run `npx skills add humanplane/homunculus --skill session-memory -a claude-code`. Or copy the skill folder (plugins/homunculus/skills/session-memory in humanplane/homunculus) into .claude/skills/session-memory in your project. Claude Code loads it when a task matches its description.

How do I install Session Memory in Codex?

Run `npx skills add humanplane/homunculus --skill session-memory -a codex`. Or copy the skill folder (plugins/homunculus/skills/session-memory in humanplane/homunculus) into .agents/skills/session-memory in your project. Codex loads it when a task matches its description.

Can I use Session Memory in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add humanplane/homunculus --skill session-memory -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/session-memory, .gemini/skills/session-memory, .github/skills/session-memory and .opencode/skills/session-memory in your project.

What does Session Memory need to run?

Going by SKILL.md and its folder, Session Memory needs the command-line tools its instructions call (jq and git).

Does Session Memory access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Session Memory safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Session Memory use?

No licence was found for Session Memory or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Session Memory use?

About 431 tokens (SKILL.md is roughly 1.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Session Memory?

Skills that share tags, products or a category with Session Memory: Coding Agent Session Finder (code-yeongyu/oh-my-openagent, 70k stars), Claude-Mem Cloud Sync (thedotmack/claude-mem, 98k stars), Cognee CLI Memory Commands (topoteretes/cognee, 32k stars) and Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Session Memory?

humanplane (a GitHub organization) maintains it in humanplane/homunculus, which has 394 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on January 23, 2026.

Source: humanplane/homunculus on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.