project-memory

Store and retrieve project memories in PostgreSQL by git repo and branch.

Updated Nov 27, 2025
One-click install
npx skills add https://github.com/sioux1to1/sioux-project-memory-claude --skill project-memory-sioux1to1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-memory
Source: https://github.com/sioux1to1/sioux-project-memory-claude/tree/main
Command: npx skills add https://github.com/sioux1to1/sioux-project-memory-claude --skill project-memory-sioux1to1

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires psycopg2, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Stores and retrieves persistent project memories (decisions, TODOs, context, patterns, notes) in PostgreSQL, automatically associating memories with the current git repo and branch.

Core Features & Use Cases

  • Automatic project identification via git repo and branch
  • Full-text search in Portuguese
  • Per-project memory across sessions and repositories
  • Quick access to summaries and last decisions

Quick Start

Run the memory API to start saving or querying your project's memories automatically.

Frequently Asked Questions about project-memory

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

FAQPage Schema
How do I persist project memory and decisions across git branches automatically?

To persist project memory across git branches, this Skill automatically identifies your current repo and branch, storing decisions, TODOs, and context in a PostgreSQL database. It provides memory isolation so memories remain specific to their respective branches.

What is the best way to store TODOs and context for multiple repositories in PostgreSQL?

Storing TODOs and context for multiple repositories in PostgreSQL is handled by this Skill's database schema. It automatically associates memories with individual git projects and branches, providing per-project storage isolation across different sessions.

How do I set up PostgreSQL to track project memory using a CLI?

To set up PostgreSQL for project memory tracking, you use the provided setup_db.sql file to create the schema and config.json for database connections. You then interact with the stored memories using the memory_api.py CLI.

Can I perform full-text search on saved project notes and patterns?

Yes, you can perform full-text search on saved project notes, decisions, and patterns directly within the PostgreSQL database. This allows you to quickly query and retrieve specific historical context across your project sessions.

Does project memory management work across different git repositories?

Project memory management works across different git repositories by automatically detecting the active git repo and branch. This ensures memory isolation, keeping decisions, TODOs, and notes separated per project context.

Do I need psycopg2 to manage persistent project memories?

Yes, you need psycopg2 installed because it serves as the PostgreSQL database adapter for the memory_api.py CLI. This dependency is required to successfully store and retrieve your project memories from the database.