How supermemoryai/claude-supermemory works
Claude-Supermemory is a Claude Code plugin that supplies persistent, repository-scoped memory through Supermemory. The main workflow starts a session by loading profile context, conditionally recalls relevant memories before prompts, and captures conversation content when a session ends. Users can also explicitly search or save memories and run project configuration, indexing, logout, and session commands. The graph includes configuration/authentication and statusline state as supporting layers. Some subsystem links are based on README statements or SOURCE INDEX references; unsampled implementations are not treated as inspected.
Main entry points: session-start.js Session Context · capture.js Auto Capture · recall-directive.js Reasoned Recall · api.js Memory API Client
Components 19
Session Memory
- Session Context
plugin/hooks/session-start.js - Reasoned Recall
plugin/hooks/recall-directive.js - Auto Capture
plugin/hooks/capture.js - Transcript Processing
plugin/hooks/lib/transcript.js - Memory API Client
plugin/hooks/lib/api.js
Configuration
- Browser Authentication
plugin/hooks/lib/auth.js - Settings and Credentials
plugin/hooks/lib/settings.js - Project Configuration
plugin/hooks/lib/project-config.js - Repository Container
plugin/hooks/lib/container-tag.js
Claude Integration
- Plugin Commands
plugin/commands/index.md - Context Gatherer
plugin/agents/context-gatherer.md - Memory Tool Proxy
plugin/hooks/mcp-proxy.js - Recall Approval
plugin/hooks/recall-approve.js
Status and State
- Statusline Renderer
plugin/statusline.js - Session Status State
plugin/hooks/lib/statusline-state.js - Last Session Link
plugin/hooks/lib/last-session.js
Other components
- Developer
- Claude Code
- Supermemory Service
Connections 33
- Developer → Claude Code: prompts
README.md - Claude Code → Session Context: starts session
plugin/hooks/session-start.js - Session Context → Settings and Credentials: loads settings
plugin/hooks/session-start.js - Session Context → Project Configuration: loads project config
plugin/hooks/session-start.js - Session Context → Repository Container: selects container
plugin/hooks/session-start.js - Session Context → Browser Authentication: authenticates if needed
plugin/hooks/session-start.js - Session Context → Memory API Client: fetches profile
plugin/hooks/session-start.js - Memory API Client → Supermemory Service: requests profile
plugin/hooks/lib/api.js - Session Context → Claude Code: injects context
plugin/hooks/session-start.js - Claude Code → Reasoned Recall: submits prompt
README.md - Reasoned Recall → Settings and Credentials: reads recall config
plugin/hooks/recall-directive.js - Reasoned Recall → Project Configuration: loads project config
plugin/hooks/recall-directive.js - Reasoned Recall → Repository Container: selects container
plugin/hooks/recall-directive.js - Reasoned Recall → Memory API Client: searches profile
plugin/hooks/recall-directive.js - Reasoned Recall → Claude Code: injects matches
plugin/hooks/recall-directive.js - Claude Code → Auto Capture: ends session
README.md - Auto Capture → Transcript Processing: processes transcript
plugin/hooks/capture.js - Auto Capture → Settings and Credentials: reads capture settings
plugin/hooks/capture.js - Auto Capture → Repository Container: selects container
plugin/hooks/capture.js - Auto Capture → Memory API Client: saves memories
plugin/hooks/capture.js - Memory API Client → Supermemory Service: writes documents
plugin/hooks/lib/api.js - Developer → Plugin Commands: runs commands
README.md - Plugin Commands → Project Configuration: configures project
- Developer → Memory Tool Proxy: requests search or save
README.md - Memory Tool Proxy → Memory API Client: uses memory API
plugin/hooks/mcp-proxy.js - Developer → Context Gatherer: requests context gathering
- Recall Approval → Session Status State: updates recall state
plugin/hooks/recall-approve.js - Session Context → Session Status State: writes context state
plugin/hooks/session-start.js - Auto Capture → Session Status State: writes capture state
plugin/hooks/capture.js - Statusline Renderer → Session Status State: reads session state
- Auto Capture → Last Session Link: stores session link
plugin/hooks/capture.js - Session Context → Statusline Renderer: installs statusline
plugin/hooks/session-start.js - Settings and Credentials → Browser Authentication: loads credentials
plugin/hooks/lib/settings.js