siftmemory

SiftMemory for Claude Code

SiftMemory is a local-first reasoning memory layer for AI coding assistants. It captures development events, extracts reasoning checkpoints, validates them against current code state, and builds compact Reasoning Resume Packs that AI models can inject into coding sessions to resume from prior validated understanding.

Features

• Resumable Reasoning: Never re-derive what you've already figured out
• Claim-Level Invalidation: Automatically invalidate reasoning when code changes
• Local-First Privacy: All data stays on your machine
• Reasoning Resume Packs: Compact context injection before compaction
• 12 Lifecycle Hooks: Captures events at the right moments
• 17 Slash Commands: Full control over memory and team operations
• MCP Server: High-level operations via Model Context Protocol
• Team Collective Memory: Share validated reasoning across your team via Git

Installation

/plugin add https://github.com/ialameh/siftmemory

The plugin includes pre-built dist/ for immediate use. No npm install required.

Prerequisites

Install the SiftMemory daemon:

cargo install --git https://github.com/ialameh/sift-memory siftmemory-daemon

Or use a pre-built binary from GitHub Releases.

Commands

Basic Commands

Command	Description
/siftmemory:check	Quick status check - daemon health and plugin state
/siftmemory:status	Detailed status with workspace and session info
/siftmemory:start	Start the daemon manually
/siftmemory:stop	Stop the daemon
/siftmemory:resume	Force injection of reasoning resume pack
/siftmemory:checkpoint	Create a reasoning checkpoint manually
/siftmemory:forget	Remove specific checkpoints from memory
/siftmemory:audit	Review checkpoint validity and sources
/siftmemory:doctor	Run diagnostics on installation

Team Commands

Command	Description
/siftmemory:team status	Show team collective memory status
/siftmemory:team pull	Pull and import team memory from repository
/siftmemory:team import	Import team collective memory into local database
/siftmemory:team promote <id>	Promote local checkpoint to team memory
/siftmemory:team review	View pending team memory reviews
/siftmemory:team approve <id>	Approve a checkpoint for team use
/siftmemory:team reject <id>	Reject a checkpoint from team use
/siftmemory:team conflicts	View unresolved team claim conflicts
/siftmemory:team tombstone <id>	Permanently exclude from team memory
/siftmemory:team explain <id>	Explain a checkpoint's state and history

Lifecycle Hooks

The plugin hooks into Claude Code lifecycle events:

Hook	Purpose	Timeout
SessionStart	Spawn daemon, check readiness	5s
UserPromptSubmit	Buffer prompt event, trigger injection	3s
PostToolUse	Capture code read/write/edit events	2s
PostToolUseFailure	Capture failed tool operations	2s
PostToolBatch	Batch capture after tool batches	5s
PreCompact	Inject resume pack before compaction	10s
PostCompact	Post-compaction event capture	5s
Stop	Record session outcome	5s
StopFailure	Handle abnormal termination	3s
SessionEnd	Final cleanup and state writeback	5s
CwdChanged	Update workspace tracking	3s
SubagentStop	Capture subagent reasoning	3s

MCP Tools

The plugin provides an MCP server (siftmemory-memory) with these tools:

Core Tools

Tool	Description
siftmemory_build_resume_pack	Build Reasoning Resume Pack for current context
siftmemory_ingest_event	Ingest a development event
siftmemory_record_outcome	Record session outcome (success/partial/failed)
siftmemory_extract_checkpoint	Extract reasoning checkpoint from events
siftmemory_inspect_memory	Inspect checkpoint validity state
siftmemory_suppress_memory	Exclude checkpoints from resume packs
siftmemory_search	Search checkpoints and claims
siftmemory_checkpoint_*	CRUD operations on checkpoints
siftmemory_stats	Get memory statistics
siftmemory_health	Check daemon health

Team Collective Tools

Tool	Description
siftmemory_collective_status	Get team collective memory status
siftmemory_collective_import	Import team memory from repository
siftmemory_collective_promote	Promote local checkpoint to team memory
siftmemory_collective_validate	Validate team claims against current code
siftmemory_collective_conflicts	Get unresolved team claim conflicts

Team Collective Memory