mnemosyne-memory

mnemosyne-memory teaches an agent to use an existing Mnemosyne MCP server as a selective continuity layer across tasks and sessions. It performs focused recall, deduplicates durable writes, corrects stale records, and maintains one compact handoff per stable project.

The skill is deliberately not a transcript recorder. Repository files remain authoritative, and broad or destructive Mnemosyne maintenance is outside its automatic workflow.

Prerequisite

Configure a Mnemosyne MCP server in the host before using this skill. The host should expose mnemosyne_* recall and mutation tools. This package does not install Mnemosyne, start a service, choose a memory bank, or bundle an MCP server.

See the Mnemosyne repository for server installation and configuration.

Agent Plugin

This directory is an Agent Plugins v1 plugin root. A compatible client with Agent Skills support loads plugin.json here and discovers the skill from the standard fixed location:

skills/mnemosyne-memory

The plugin is independently versioned. Installation and update behavior is defined by the client loading this package. Its absence of mcp.json is intentional: the skill uses an MCP server already configured by the host.

Automatic use

Depending on the host, the skill may be invoked explicitly or selected implicitly. For reliable automatic continuity, add a short rule to the host's applicable governing instructions requiring mnemosyne-memory for substantive tasks. Keep profile-specific bank selection, privacy rules, and retention policy in those governing instructions rather than in this public skill.

The skill never hardcodes profile names or local paths. The host-configured Mnemosyne connection owns bank isolation.

Safety model

Automatic behavior is limited to focused recall and selective remember, update, or invalidate operations. The skill does not automatically run consolidation, import/export, synchronization, shared-surface writes, hygiene cleanup, deletion, persona changes, cross-bank transfer, or broad maintenance.

It excludes secrets, authentication material, raw transcripts, logs, command output, and sensitive content whose persistence is not clearly authorized.

Portable package files

plugin.json                                   Agent Plugins v1 manifest
LICENSE                                       MIT license terms
README.md                                     usage and safety guidance
skills/mnemosyne-memory/SKILL.md              portable skill instructions

Development

In a Charms source checkout, run the package tests from the repository root:

python3 -m unittest discover -s packages/mnemosyne-memory/tests -p 'test_*.py'