К основному содержанию
скилл CX Codex

mnemos — скилл для Claude Code: сохранить память при компакции контекста

Скилл mnemos, который предотвращает потерю важной информации при компакции контекста. Структурирует рабочую память как типизированный граф, где решения и цели никогда не теряются, а менее важные данные сжимаются по правилам.

MIT 134 установок ★ 713 обновлён 2026-10-13

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add alinaqi/maggy --skill mnemos -a claude-code
Открыть на GitHub

Что делает mnemos

mnemos отслеживает четыре измерения усталости агента — наполнение контекста, разброс между папками, повторное чтение файлов и частота ошибок. Когда усталость растёт, скилл автоматически срабатывает: микро-консолидация сжимает результаты, checkpoint пишется на диск, а при приближении к пределу контекста готовит экстренный checkpoint для восстановления.

При компакции срабатывает трёхслойная защита. Сначала PreCompact hook пишет инструкции сохранения и маркер в .mnemos/just-compacted. Потом SessionStart крючок — если он сработает — сразу после компакции перезагружает полный checkpoint в свежий контекст (это основной способ). Если SessionStart не сработает, первый вызов инструмента сам обнаружит маркер и восстановит контекст.

Включает команды для ручного управления: mnemos add goal, mnemos checkpoint --force, mnemos status. Может проанализировать сессии Claude Code — скилл вычисляет haziness каждой сессии по пяти измерениям (плотность исправлений, переделки, ошибки с первой попытки, заблудившиеся инструменты, откаты) и показывает, насколько запутанной была работа.

Какие задачи решает

  • спасти цели и ограничения при обрезке контекста
  • отследить усталость агента по четырём сигналам
  • восстановить полный checkpoint после компакции
  • оценить, насколько запутанной была сессия кодирования
  • checkpoint результатов перед передачей задачи

Примеры запросов агенту

  • Создай GoalNode в начале: mnemos add goal "Собрать API для учёта расходов" --task-id session-1
  • Перед долгой операцией проверь усталость: mnemos fatigue
  • После компакции контекста automatически вернётся checkpoint с целью и прогрессом

Как установить mnemos

1Через Skills CLI (Vercel)

npx skills add alinaqi/maggy --skill mnemos -a claude-code

2Вручную: положить файлы

~/.claude/skills/mnemos/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/mnemos/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о mnemos

Как установить mnemos в Claude Code?

Выполни npx skills add alinaqi/maggy --skill mnemos -a claude-code, затем открой ~/.claude/skills/mnemos/SKILL.md. Для Cursor команда: npx skills add alinaqi/maggy --skill mnemos -a cursor; для GitHub Copilot: gh skill install alinaqi/maggy mnemos.

Зачем нужен mnemos?

Когда Claude Code обрезает контекст при переполнении, агент теряет решения и цели. mnemos запоминает их как типизированные узлы и восстанавливает после обрезки через SessionStart крючок, чтобы агент не начинал с нуля.

Что такое haziness и как её посмотреть?

Haziness — оценка запутанности сессии по пяти метрикам (исправления, переделки, ошибки, заблудившиеся инструменты, откаты). Команда mnemos haze --recent 10 показывает таблицу последних сессий с оценкой в диапазоне от clear до lost.

Исходный текст

SKILL.md · MIT
---
name: mnemos
description: Task-scoped memory lifecycle — typed MnemoGraph prevents lossy context compaction by treating facts/decisions/code-refs/handoffs as distinct node types with per-type eviction policies
when-to-use: "When you need durable working memory across compactions — checkpoint decisions, preserve task handoffs, or audit what was remembered"
user-invocable: false
effort: high
---

# Mnemos — Task-Scoped Memory Lifecycle

## What It Does

Mnemos prevents lossy context compaction from destroying the structured knowledge you need most. It treats your working memory as a **typed graph** (MnemoGraph) where different types of knowledge have different eviction policies:

- **GoalNodes** and **ConstraintNodes** are NEVER evicted — they survive all compaction
- **ResultNodes** are compressed (summary kept) before eviction
- **ContextNodes** are evictable when their activation weight drops
- **CheckpointNodes** persist to disk for session resume

## Fatigue Model

Mnemos monitors 4 dimensions of "agent fatigue" — all passively observed from hook data, no manual input needed:

| Dimension | Weight | Signal Source | What It Measures |
|-----------|--------|--------------|-----------------|
| Token utilization | 0.40 | Statusline JSON | How full the context window is |
| Scope scatter | 0.25 | PreToolUse file paths | How many directories the agent is bouncing between |
| Re-read ratio | 0.20 | PreToolUse Read calls | How often the agent re-reads files it already read (context loss) |
| Error density | 0.15 | PostToolUse outcomes | What fraction of tool calls are failing (agent struggling) |

Fatigue states and actions:

| State | Score | Action |
|-------|-------|--------|
| FLOW | 0.0–0.4 | Normal operation |
| COMPRESS | 0.4–0.6 | Micro-consolidation runs (compress 3 ResultNodes, evict 1 cold ContextNode) |
| PRE-SLEEP | 0.6–0.75 | Checkpoint written, consolidation runs |
| REM | 0.75–0.9 | Emergency checkpoint, consider wrapping up |
| EMERGENCY | 0.9+ | Checkpoint written, hand off immediately |

## How To Use

### Automatic (hooks handle everything):
1. **Statusline** writes `fatigue.json` on every API call
2. **PreToolUse** hook reads fatigue before every edit, auto-checkpoints at 0.60+
3. **PreCompact** hook writes emergency checkpoint, compaction marker, and tells summarizer what to preserve
4. **SessionStart "compact"** fires immediately after compaction, re-injects full checkpoint (primary restore)
5. **SessionStart "startup|resume"** loads last checkpoint on new/resumed sessions
6. **PreToolUse fallback** (no matcher) detects compaction marker if SessionStart didn't fire
7. **Stop** hook writes final checkpoint for next session

### Post-Compaction Recovery (Three-Layer Defense):
When Claude Code compacts the context (~83% full), Mnemos uses three layers:
- **Layer 1 (PreCompact)**: Outputs strong preservation instructions with inline checkpoint content for the summarizer. Writes `.mnemos/just-compacted` marker.
- **Layer 2 (SessionStart "compact")**: **PRIMARY re-injection.** Fires immediately when Claude resumes after compaction — before any agent action. Consumes the marker and injects the full checkpoint into the fresh context. This is the recommended approach per the RFC (Wake State Reconstruction).
- **Layer 3 (PreToolUse fallback)**: If SessionStart doesn't fire (older versions, edge cases), the first tool call triggers `mnemos-post-compact-inject.sh` which detects the marker and injects. Safety net only.

The result: after compaction, you'll see a "CONTEXT RESTORED AFTER COMPACTION" block with your goal, constraints, what you were working on, and progress. Resume from there.

### Manual CLI:
```bash
mnemos init                    # Initialize .mnemos/
mnemos status                  # Show node counts + fatigue
mnemos fatigue                 # Detailed fatigue breakdown
mnemos checkpoint --force      # Write checkpoint now
mnemos resume                  # Output checkpoint for context
mnemos consolidate             # Run micro-consolidation
mnemos nodes --type goal       # List active GoalNodes
mnemos add goal "Build auth"   # Add a GoalNode
mnemos bridge-icpg             # Import iCPG ReasonNodes
mnemos ingest-claude --all     # Ingest Claude Code transcripts (see below)
mnemos haze --recent 10        # Show per-session haziness scores
```

## Claude Transcript Ingestion & Haziness

Mnemos can ingest Claude Code session transcripts (the per-session JSONL under
`~/.claude/projects/`) and score each session's **haziness** — a measure of how
much the agent struggled. The `Stop` hook does this automatically on session
exit; it is also available manually.

**What's stored:** only structural fields (roles, tool names, file paths, error
flags, timestamps) plus a **redacted, 200-char preview** of each turn. Full
content is never persisted, and secrets (API keys, tokens, PEM blocks, JWTs,
credentials) are redacted before anything touches disk.

**Haziness** is a weighted score over five dimensions, each in `[0,1]`:

| Dimension | Weight | What it measures |
|-----------|--------|------------------|
| correction_density | 0.30 | User corrections per eligible user turn |
| redo_ratio | 0.25 | Edits re-touched after an error |
| first_try_error_rate | 0.20 | Edits followed by errors within 3 turns |
| orphan_tool_use_rate | 0.15 | Tool calls with no matching result |
| backtrack_norm | 0.10 | `git revert`/`reset --hard`/`restore` calls |

The composite maps to a band: `clear` < 0.25 ≤ `cloudy` < 0.50 ≤ `hazy` < 0.75 ≤ `lost`.

```bash
mnemos ingest-claude --all              # ingest every transcript + score
mnemos ingest-claude --session <id>     # one session by id
mnemos ingest-claude --transcript <f>   # a specific JSONL file
mnemos haze --recent 10                 # table of recent sessions
mnemos haze --session <id>              # per-dimension breakdown
```

Ingestion is idempotent (resumes via `last_line_offset`). **Opt out per project**
with `touch .mnemos/claude-log.disabled`.

## Agent Instructions

When working on a task:

1. **Create a GoalNode** at the start: `mnemos add goal "what you're trying to achieve" --task-id session-1`
2. **Add ConstraintNodes** for invariants: `mnemos add constraint "API backward compatibility" --scope src/api/`
3. **Check fatigue** before long operations: `mnemos fatigue`
4. **Checkpoint at sub-goal boundaries**: `mnemos checkpoint`
5. **On session resume**: the SessionStart hook automatically loads your checkpoint

## iCPG Integration

Mnemos bridges with iCPG (Intent-Augmented Code Property Graph):
- `mnemos bridge-icpg` imports active ReasonNodes as GoalNodes
- Postconditions/invariants become ConstraintNodes
- Checkpoint includes iCPG state (active intent, unresolved drift)

## Storage

Everything lives in `.mnemos/` (gitignored):
- `mnemo.db` — SQLite MnemoGraph
- `fatigue.json` — Live token metrics (updated per API call by statusline)
- `signals.jsonl` — Behavioral signal log (appended by PreToolUse + PostToolUse hooks)
- `checkpoint-latest.json` — Most recent checkpoint
- `checkpoints/` — Archived checkpoints

© alinaqi · MIT · alinaqi/maggy

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
State Memory MCP putervision State Memory MCP — MCP-сервер для Claude Code, который хранит в локальном графе SQLite контекст, задачи, блокировки и решения между сессиями. CX Codex +1 ★ 44звёзд репо wheypoint paulnsorensen Скилл wheypoint записывает состояние работы в durable-чекпоинт, чтобы другая сессия агента могла продолжить с того же места. CX Codex +1 790установок adr-create ruvnet Скилл adr-create для Claude Code и пяти других платформ создаёт Architecture Decision Record с порядковым номером, регистрирует его в графе AgentDB и связывает с похожими решениями. Запускается на команду с названием решения. CX Codex +1 743установок data-structure-protocol k-kolomeitsev Скилл data-structure-protocol создаёт граф зависимостей кодовой базы в папке .dsp/ и помогает агентам ориентироваться в архитектуре модулей, экспортах и причинах связей. CX Codex +1 ★ 67звёзд репо Echo Memory echo-mem Echo Memory — MCP-сервер для Claude Code и других агентов, который хранит общую память как граф фактов в Postgres. Запись одного агента становится доступной другим без вызова модели. CX Codex +1 ★ 2звёзд репо engrava sovantica MCP-сервер подключает базу долгосрочной памяти Engrava к AI-агенту. Даёт поиск через MindQL, полнотекстовый индекс и граф мыслей через протокол stdio. CX Codex +1 ★ 1звёзд репо

Из того же набора61

Весь набор →
shopify-apps Скилл shopify-apps помогает собирать приложения Shopify на Remix, работать с Admin GraphQL API и создавать checkout-расширения. Пригодится при разработке приложения или расширения для магазина. CX Codex +1 273установок azure-cosmosdb Скилл Claude Code разбирает partition keys, консистентность, change feed и паттерны SDK для Azure Cosmos DB; содержит примеры CRUD, иерархических ключей и cross-partition запросов. CX Codex +1 269установок workspace Скилл workspace анализирует архитектуру монорепозиториев и связанных проектов. Находит общие контракты API и типы, чтобы агент не ломал связи между сервисами. CX Codex +1 198установок cpg-analysis Скилл cpg-analysis для Claude Code анализирует потоки управления и данных через Joern CPG и CodeQL. Применяется при сложном рефакторинге и аудите безопасности. CX Codex +1 175установок icpg Скилл icpg отслеживает, ПОЧЕМУ существует каждая функция и модуль, через граф причин (ReasonNodes) с формальными контрактами. CX Codex +1 156установок maggy Скилл maggy для Claude Code собирает тикеты GitHub Issues и Asana в один инбокс, запускает TDD-прогон из тикета и готовит ежедневную сводку по конкурентам. CX Codex +1 131установок cross-agent-delegation Скилл cross-agent-delegation маршрутизирует задачи между Claude, Kimi и Codex на основе оценки сложности, чекпоинтов Mnemos и графа iCPG. CX Codex +1 122установок polyphony Скилл polyphony запускает каждого ИИ-агента в отдельном Docker-контейнере со своей git-веткой, чтобы параллельные агенты не конфликтовали друг с другом. CX Codex +1 116установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой