# Reflexio Consolidate

> Run a full-sweep consolidation over all .reflexio/ files — TTL sweep + n-way cluster merge. Use when the user asks to 'clean up reflexio', 'consolidate memory', 'deduplicate playbooks', or suspects drift across sessions. Use when this capability is needed.

- Skill: `tomevault-io/reflexio-consolidate` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/reflexio-consolidate`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/reflexio-consolidate/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/reflexio-consolidate

---


# Reflexio Consolidate

User-invocable via `/skill reflexio-consolidate`. Same workflow that runs automatically via heartbeat (every 24h of active use), but on-demand.

## What it does

1. TTL sweep: delete expired profile files.
2. For each of profiles and playbooks:
   - Cluster similar files via `memory_search`.
   - For clusters of 2+ members, call `llm-task` with `prompts/full_consolidation.md` to decide consolidate (one-fact-per-file) or keep-all.
   - Apply decisions: write individual fact files, delete originals.

## How to run

Call the `reflexio_run_consolidation` tool. It spawns the consolidator sub-agent and returns a `runId`.

After successful consolidation, call the `reflexio_consolidation_mark_done` tool to update the heartbeat timer.

## When to use

- User asks to "consolidate", "clean up reflexio", "dedupe memory"
- User reports seeing duplicate or contradictory entries in retrieval
- Heartbeat check returns ALERT (automatic trigger)

## When NOT to use

- Routine maintenance — heartbeat handles this automatically.
- Immediately after Flow A/B writes — shallow dedup at write time + Flow C at session end cover the fresh-extraction cases.

---
> Source: [ReflexioAI/reflexio](https://github.com/ReflexioAI/reflexio) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-07-04 -->

