# Aim Purge

> Purge old memories from Qdrant collections with safety guards

- Skill: `hidden-history/aim-purge` (Agent Skill)
- Install (CLI): `npx skillmds@latest add hidden-history/aim-purge`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hidden-history/aim-purge/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Hidden-History (https://skillmd.com/u/hidden-history)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/hidden-history/aim-purge

---


Purge old memories from Qdrant collections with safety guards.

Default (no `--confirm`): dry-run preview — shows what would be purged, no deletions.
`--confirm`: executes the purge. **Irreversible** — audit log written to `.audit/logs/purge-log.jsonl`.

## Canonical Execution

```bash
"${AI_MEMORY_INSTALL_DIR:-$HOME/.ai-memory}/scripts/memory/run-with-env.sh" purge_collections.py \
    --older-than <duration> \
    [--collection <name>] \
    [--confirm]
```

## Parameters

- `--older-than` (required): duration string — `30d`, `2w`, `3m`, `1y`
- `--collection`: limit purge to one collection (default: all four)
- `--confirm`: execute the purge (absence = dry-run safety gate)

## Script

`scripts/memory/purge_collections.py`