-
Notifications
You must be signed in to change notification settings - Fork 2
Installation
Total Recall installs as a global npm package and configures itself for your editor with a single command. The only requirement is Node.js >= 18.
npm install -g totalrecallaiThe install command detects your installed editors and configures Total Recall for each one:
totalrecall installtotalrecall install --claude-codeThe Claude Code installer registers 4 hooks and an MCP server in your Claude Code configuration:
| Hook | Trigger | Purpose |
|---|---|---|
PreToolUse |
Before any tool runs | Injects previous session context into the AI prompt |
PostToolUse |
After a tool completes | Captures file writes, commands, and research observations |
Notification |
User sends a prompt | Records user prompts for session continuity |
Stop |
Session ends | Generates a structured session summary |
Claude Code gets the deepest integration because hooks capture events automatically without requiring the AI to call MCP tools explicitly.
totalrecall install --cursorThe Cursor installer creates two files:
-
.cursor/rules/totalrecall.mdc— Rules file that instructs the AI to use Total Recall MCP tools -
.cursor/mcp.json— MCP server configuration pointing to thetotalrecall mcp-servercommand
totalrecall install --windsurfThe Windsurf installer creates:
-
.windsurfrules— Rules file with memory instructions -
~/.codeium/windsurf/mcp_config.json— MCP server configuration
totalrecall install --clineThe Cline installer creates:
-
.clinerules— Custom instructions with memory instructions - MCP server configuration in Cline's VS Code settings
git clone https://github.com/Auriti-Labs/kiro-memory.git
cd kiro-memory
npm install && npm run build
npm run install:kiroThe service install command registers the worker to start automatically when your system boots:
totalrecall service installTotal Recall uses cascading detection to choose the best strategy:
-
systemd (preferred) — Creates a user service at
~/.config/systemd/user/totalrecall-worker.servicewith automatic restart on failure -
crontab — Adds an
@rebootentry if systemd is not available
To check status or remove:
totalrecall service status
totalrecall service uninstallnpm update -g totalrecallai
totalrecall --versionThe worker automatically uses the new version at the next session start. To apply immediately:
npm run worker:restartThe doctor command checks your environment: Node.js version, database access, worker status, embedding support, and editor configuration.
totalrecall doctorThe doctor --fix command auto-repairs detected issues including rebuilding the FTS5 index, removing orphaned embeddings, and running VACUUM:
totalrecall doctor --fixTotal Recall Wiki
- Home
- Installation
- Configuration
- CLI Reference
- SDK Reference
- MCP Tools
- Architecture
- Troubleshooting
- FAQ