Description

Claude Code v2.1.126 (May 2026) added claude project purge [path] — a command that deletes all Claude Code state associated with a project: transcripts, tasks, file history, config entries.

CLI flags:

• --dry-run: preview what would be deleted
• -y/--yes: skip confirmation prompt
• -i/--interactive: step through each artifact interactively
• --all: purge all projects at once

Relevance to Zeph

Zeph accumulates project-specific state across sessions:

• SQLite message history
• MAGMA graph memory (entities, relations)
• SYNAPSE embeddings (Qdrant collection)
• Scene/episodic store entries
• Skill outcomes and trajectory data
• Debug dumps and trace artifacts

Currently there is no single CLI command to reset all of this for a given project. Users must manually delete the SQLite DB, the Qdrant collection, and trace directories. This is a UX friction point for:

• Starting fresh after a botched experiment
• Handing off a project to another user
• Cleaning up disk space after a completed engagement

Proposed command: zeph project purge [--config <path>] [--dry-run] [-y] that invokes memory.drop_all(), removes the local SQLite DB, truncates the skill outcomes table, and deletes debug artifacts for the configured project path.

The --dry-run flag lists what would be removed (byte counts per category) without deleting.

References

• Claude Code v2.1.126: https://github.com/anthropics/claude-code/releases
• Feature details: https://wotai.co/blog/claude-code-2-1-126