shield_lock
JinDaGe
← Back to skills
extension
Category: Content & MediaNo API key required

amnesia

Set up persistent memory and identity for AI agents. Use when the user wants to give an agent persistent identity, manage agent memory files, set up IDENTITY.md/SOUL.md/MEMORY.md, create memory backup systems, or implement file-based agent continuity. Triggers on "agent memory," "persistent identity," "IDENTITY.md," "MEMORY.md," "SOUL.md," "agent backup," "remember across sessions," or "agent continuity."

personAuthor: jakexiaohubgithub
open_in_newRepositorydownloadDownload package

Amnesia

Memory management toolkit for AI agents. Because forgetting is not an option.

Quick Start

  1. Copy templates to workspace:
cp assets/templates/*.md /path/to/agent/workspace/

  1. Fill in each template with agent-specific information

  2. Set up automated backups:

cp scripts/backup.sh /path/to/agent/scripts/
chmod +x /path/to/agent/scripts/backup.sh

Core Files

| File | Purpose | |------|---------| | IDENTITY.md | Who the agent is — name, birthday, capabilities | | SOUL.md | How the agent behaves — values, style, boundaries | | MEMORY.md | Curated long-term memories | | USER.md | Information about the primary user | | TOOLS.md | Environment-specific notes | | memory/*.md | Daily episodic logs |

Setting Up Identity

IDENTITY.md

Define static facts about the agent:

# IDENTITY.md - Who Am I?

- **Name:** [Agent name]
- **Creature:** [What the agent is]
- **Vibe:** [One-line personality]
- **Emoji:** [Representative emoji]
- **Birthday:** [Creation date]

SOUL.md

Define behavioral guidelines:

# SOUL.md - Who You Are

## Core Truths
[Fundamental principles]

## Boundaries
[What the agent won't do]

## Vibe
[Communication style]

Memory Architecture

Long-term Memory (MEMORY.md)

Curated, important information:

  • Key learnings with dates
  • Important facts
  • People and relationships
  • Project status
  • Preferences discovered
  • Mistakes to avoid

Daily Logs (memory/YYYY-MM-DD.md)

Raw episodic memory:

  • Session starts
  • Events and timestamps
  • Conversations
  • Learnings
  • Tomorrow's tasks

Maintenance cycle: Periodically review daily logs → extract insights → update MEMORY.md

Backup System

backup.sh

Backs up workspace to git:

./scripts/backup.sh [workspace_dir] [backup_repo_dir]

Run on a cron schedule (e.g., hourly):

0 * * * * /path/to/scripts/backup.sh

restore.sh

Restores from backup after a wipe:

./scripts/restore.sh [backup_repo_dir] [workspace_dir]

new-day.sh

Initializes today's memory log:

./scripts/new-day.sh [workspace_dir]

Session Startup Checklist

When an agent starts a new session:

  1. Read IDENTITY.md — establish who you are
  2. Read SOUL.md — establish how you behave
  3. Read USER.md — know who you're helping
  4. Read MEMORY.md — recall long-term context
  5. Read memory/YYYY-MM-DD.md (today + yesterday) — recent context
  6. Check TOOLS.md — environment specifics

Best Practices

  • Save immediately — Don't rely on context; write to files
  • Date your entries — When was this learned?
  • Curate aggressively — Not everything goes in MEMORY.md
  • Back up frequently — Hourly is good, more often is better
  • Version control everything — Git is your friend

Resources

  • Templates: assets/templates/
  • Scripts: scripts/
  • GitHub: https://github.com/mulletmcnasty/amnesia