memory-system

Manage cross-session memory with a three-layer stack via memory_cli.py.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/alishangtian/proteus-ai --skill memory-system-alishangtian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: memory-system
Source: https://github.com/alishangtian/proteus-ai/tree/main/proteus/docker/volumes/agent/skills/memory-system
Command: npx skills add https://github.com/alishangtian/proteus-ai --skill memory-system-alishangtian

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires chromadb, requests, pyyaml, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

AI agents often lose important context across conversations, hindering continuity and user experience. The memory-system skill provides a unified three-layer memory stack to preserve short-term work-in-progress, mid-term session summaries, and long-term knowledge for persistent personalization.

Core Features & Use Cases

  • Short-term memory buffer for immediate conversational context and calculations.
  • Medium-term memory with date-slotted JSONL storage for session summaries and recent preferences.
  • Long-term memory with SQLite plus optional vector indexing for semantic search and personalization across sessions.
  • CLI-driven operations via memory_cli.py to store, retrieve, and monitor memory across multi-session workflows.

Quick Start

Use memory_cli.py to store a memory entry from the current session and then retrieve related memories to maintain cross-session continuity.

Frequently Asked Questions about memory-system

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I persist AI agent context across multiple sessions?

To persist AI agent context across multiple sessions, this system uses a three-layer memory stack storing short-term work-in-progress, mid-term session summaries, and long-term knowledge. It enables persistent personalization for multi-turn interactions and long-running tasks.

What is the best way to manage cross-session memory for personalized assistants?

The best way to manage cross-session memory for personalized assistants is using a three-layer architecture: a short-term buffer, date-slotted JSONL session summaries, and SQLite with optional vector indexing for semantic search and personalization.

How do I store and retrieve memory entries via CLI for AI workflows?

You store and retrieve memory entries via CLI using memory_cli.py. The CLI-driven operations allow you to maintain cross-session continuity by saving current session entries and retrieving related memories through minimal YAML configuration.

Does cross-session memory with vector indexing work with SQLite?

Yes, cross-session memory with vector indexing works with SQLite. The long-term memory layer uses SQLite for storage and applies optional vector indexing to enable semantic search and personalization across sessions.

Can I use Ollama-backed embeddings for semantic memory search?

Yes, you can use Ollama-backed embeddings for semantic memory search. The memory-system supports Ollama as an optional embedding provider alongside a minimal YAML and CLI configuration covering memory, llm, and embedding providers.

Do I need chromadb to run cross-session memory operations?

Yes, chromadb is required as a dependency for cross-session memory operations. The system also requires requests and pyyaml, and includes initialization checks and error handling to manage memory across multi-session workflows.