How do I purge a project from memory?

[resting]

How do I purge a project from memory?

[MLuc24]

There's no CLI command for it. The npx surface is only install, uninstall, server, doctor, telemetry, runtime — nothing that forgets a project.

A purge does exist, but only on the Postgres/team server:

// DELETE /v1/projects/:projectId/memory — forget EVERYTHING captured for a
// project (observations, raw events, sessions, jobs). Keeps the project shell.
app.delete('/v1/projects/:projectId/memory', writeAuth, this.asyncHandler(async (req, res) => {

That route is in ServerV1PostgresRoutes.ts. ServerV1Routes.ts — the local SQLite server — has no equivalent, so on a normal local install it isn't reachable.

For local, it's a SQLite file at ~/.claude-mem/claude-mem.db, and the schema is set up so one delete does the work:

CREATE TABLE IF NOT EXISTS memory_items (
  ...
  project_id TEXT NOT NULL,
  ...
  FOREIGN KEY(project_id) REFERENCES projects(id) ON DELETE CASCADE,

server_sessions, agent_events and memory_items all cascade from projects(id), and the FTS index is cleaned by triggers on memory_items. So:

cp ~/.claude-mem/claude-mem.db ~/claude-mem.db.bak   # stop the server first
sqlite3 ~/.claude-mem/claude-mem.db

PRAGMA foreign_keys = ON;          -- off by default per connection; without it nothing cascades
SELECT id, name FROM projects;     -- find the right id
DELETE FROM projects WHERE id = 'the-id';

The PRAGMA line is the part that bites — leave it out and you delete the project row and orphan every memory item behind it.

If you'd rather keep the project registered and only wipe what it captured (what the server route does), delete from memory_items, agent_events and server_sessions by project_id instead and leave the projects row alone.