cass-memory

Builds persistent cross-agent procedural memory from coding session history.

3|1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/burningportra/agent-flywheel-plugin --skill cass-memory-burningportra
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cass-memory
Source: https://github.com/burningportra/agent-flywheel-plugin/tree/main/skills/cass-memory
Command: npx skills add https://github.com/burningportra/agent-flywheel-plugin --skill cass-memory-burningportra

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? AI coding agents forget everything between sessions, so the same mistakes repeat and hard-won patterns are lost. This Skill turns scattered agent session logs into a persistent, cross-agent procedural memory system with distilled rules, confidence tracking, and safety guards. ## Core Features & Use Cases - Context Hydration: Run cm context "<task>" --json before any non-trivial task to retrieve relevant playbook rules, anti-patterns, and history snippets scored by relevance. - Playbook Learning: Rules are distilled from sessions via an automated reflect-and-curate pipeline, with confidence decay, maturity progression (candidate → established → proven), and anti-pattern inversion. - Trauma Guard: Blocks dangerous commands (e.g., rm -rf /, DROP TABLE, force pushes) via Claude Code and Git pre-commit hooks based on learned incident patterns. - Use Case: A pattern discovered during a Cursor session automatically surfaces as a rule when Claude Code starts a similar task the next day, with feedback marks (cm mark <id> --helpful/--harmful) continuously refining rule quality. ## Quick Start Ask the agent to run cm context with a description of your current task in JSON mode, then follow the returned rules and leave inline feedback comments as you work.

Frequently Asked Questions about cass-memory

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

FAQPage Schema
How do I get relevant rules before starting a coding task?

Run cm context with a task description and the --json flag before starting work. It returns relevantBullets scored by relevance, antiPatterns from past failures, historySnippets from prior sessions, and suggested queries for deeper investigation.

How does the playbook learn from past agent sessions?

An automated reflect-and-curate pipeline extracts patterns from session logs, validates them against cass history, and merges them deterministically. Rules gain or lose confidence through helpful and harmful feedback marks, with a 90-day decay half-life.

Does cass-memory work with agents other than Claude Code?

Yes, it aggregates session logs from multiple agents including Cursor, Codex, Aider, and Gemini through the cass episodic memory layer. A pattern discovered in one agent automatically benefits others, with cross-agent enrichment being opt-in.

How do I block dangerous commands like rm -rf or DROP TABLE?

Install trauma guard hooks with cm guard --install for Claude Code or cm guard --git for a Git pre-commit hook. It ships with over 20 built-in doom patterns, and you can add custom patterns with cm trauma add.

What happens when cass or an LLM API key is unavailable?

The system degrades gracefully: without cass it falls back to playbook-only scoring, without an LLM it uses deterministic reflection, and offline it relies on the cached playbook and local diary. Commands continue to work in all modes.