ErrLookup › thedotmack/claude-mem
thedotmack/claude-mem
Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More · JavaScript · 379 source files
Analyzed at d768ba3643 on 2026-08-13. 183 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| SSE stream returned HTTP ${response.status} | exception | warning | sse, network, worker, openclaw, reconnect |
| SSE stream response has no body | exception | warning | sse, runtime, fetch, openclaw, reconnect |
| Hand-edited shell string detected in ${filePath} (mcp-search | exception | critical | build, verification, shell-template, rule-a, canonical |
| Hand-edited shell string detected in ${filePath} (${dottedPa | exception | critical | build, verification, shell-template, rule-a, hooks |
| Hand-edited Windows shell string detected in ${filePath} (${ | exception | critical | build, verification, shell-template, rule-a, windows |
| plugin/scripts/bun-runner.js is missing fixBrokenScriptPath | exception | critical | build, verification, rule-c, runtime-safety, bun-runner |
| plugin/scripts/bun-runner.js uses optional chaining (?.) or | exception | critical | build, verification, compatibility, node, parser, issue-2791 |
| mcp-server.cjs contains a Bun-only ${bunRequireMatch[0]} cal | exception | critical | build, verification, bundle, bun, node, mcp-server, pr-1645 |
| mcp-server.cjs contains external ${zodRequireMatch[0]}. Clau | exception | critical | build, verification, bundle, zod, mcp-server, claude-desktop |
| Missing onboarding explainer source: ${onboardingExplainerSr | exception | critical | build, verification, onboarding, skills, source-tree |
| Missing required distribution file: ${filePath} | exception | critical | build, verification, distribution, plugin |
| plugin/hooks/codex-hooks.json contains unsupported Codex roo | exception | critical | build, verification, codex, hooks, schema |
| plugin/hooks/codex-hooks.json contains unknown Codex hook ev | exception | critical | build, verification, codex, hooks, events |
| .agents/plugins/marketplace.json must point claude-mem sourc | exception | critical | build, verification, codex, marketplace, plugin-root |
| plugin/.mcp.json mcp-search launcher must include Codex cach | exception | critical | build, verification, mcp, codex, plugin-root, cache-fallback |
| plugin/.mcp.json mcp-search launcher must include Claude cac | exception | critical | build, verification, mcp, claude, plugin-root, cache-fallback |
| ${timeoutMessage} (timed out after ${timeoutMs}ms) | exception | error | network, timeout, worker, abort, queue-script |
| Failed to get processing status: ${res.status} | exception | error | network, worker, http, queue-script, processing-status |
| Failed to trigger processing: ${res.status} | exception | error | network, worker, http, queue-script, processing |
| Discord API error: ${response.status} - ${errorText} | exception | error | discord, webhook, network, release, ci |
| Invalid CLAUDE_MEM_WORKER_PORT in settings.json: missing | exception | error | config, validation, settings, worker, export |
| Invalid CLAUDE_MEM_WORKER_PORT in settings.json: ${rawPort} | exception | error | config, validation, port, settings, export |
| Worker request timed out after ${WORKER_FETCH_TIMEOUT_MS}ms: | exception | error | network, timeout, worker, export, fetch |
| Failed to search: ${searchResponse.status} ${searchResponse. | exception | error | network, http, api, worker, export |
| Failed to fetch SDK sessions: ${sessionsResponse.status} ${s | exception | error | network, http, api, worker, export |
| gh ${args.join(' ')} failed: ${detail} | exception | error | github, cli, gh, process |
| Could not parse ${label} JSON: ${message} | exception | error | json, parsing, github, gh |
| Not in a git repository. Run this from a checked-out repo. | exception | error | git, environment, precondition |
| GitHub CLI is not available. Install gh and try again. | exception | error | github, cli, dependencies, environment |
| GitHub CLI is not authenticated. Run "gh auth login". ${auth | exception | error | github, authentication, cli, precondition |
| strip introduced ${afterErrs - beforeErrs} new parse error(s | exception | error | typescript, parsing, build, safety, tooling |
| Unknown Claude model: ${options.model}. Allowed: ${[...allow | exception | error | config, validation, cli, model, auth |
| CLAUDE_MEM_QUEUE_ENGINE is not "bullmq" | exception | error | queue, config, redis, bullmq, validation |
| ${ctx.component} failed during ${ctx.phase}: ${causeMessage( | exception | critical | install, abort, error-reporting, installer |
| Bun installation completed but binary not found. Please rest | exception | error | install, bun, runtime, path, dependencies |
| Failed to install Bun. Please install manually: ${manualInst | exception | error | install, bun, runtime, network, dependencies |
| uv installation completed but binary not found. Please resta | exception | error | install, uv, runtime, path, python |
| Failed to install uv. Please install manually: ${manualInstr | exception | error | install, uv, runtime, network, python |
| Post-install check failed: unresolvable modules: ${unresolva | exception | error | install, dependencies, modules, node-modules, zod |
| installPluginDependencies: no package.json at ${targetDir} | exception | error | install, validation, filesystem, plugin, precondition |
| bun install failed in ${targetDir} ${describeExecError(err)} | exception | error | install, bun, network, windows, exec |
| Folder does not exist: ${folderPath} | exception | error | filesystem, claude-md, io, race-condition |
auth_invalid Anthropic API key not configured | exception | error | auth, claude, provider, config, api-key |
parse_error Anthropic returned invalid JSON | exception | error | parse, claude, provider, network, proxy |
auth_invalid Gemini API key not configured | exception | error | auth, gemini, provider, config, api-key |
parse_error Gemini returned invalid JSON | exception | error | parse, gemini, provider, network, proxy |
auth_invalid OpenRouter API key not configured | exception | error | auth, openrouter, provider, config, api-key |
parse_error OpenRouter returned invalid JSON | exception | error | parse, openrouter, provider, network, proxy |
| generation parse error: ${outcome.reason} | exception | error | generation, parse, llm, queue, truncation |
| "${key}" is required | validation | error | mcp, validation, recall, arguments |
| Unknown tool: ${name} | exception | error | mcp, recall, routing, validation |
| Invalid CLAUDE_MEM_QUEUE_ENGINE=${raw}; expected sqlite or b | validation | error | config, queue, env, validation |
| Invalid CLAUDE_MEM_REDIS_MODE=${value}; expected external, m | validation | error | config, redis, env, validation |
| Invalid CLAUDE_MEM_REDIS_PORT=${value}; expected a TCP port | validation | error | config, redis, env, validation, port |
| CLAUDE_MEM_REDIS_URL must use redis:// or rediss:// | validation | error | config, redis, url, validation, tls |
| Invalid Redis database in CLAUDE_MEM_REDIS_URL: ${parsed.pat | validation | error | config, redis, url, validation |
| API key is scoped to a different project | exception | error | auth, authorization, mcp, multi-tenant, api-key |
| `server ${commandLabel}` is a server runtime command, but CL | validation | error | config, runtime, env, cli |
| CLAUDE_MEM_SERVER_DATABASE_URL is required for `server ${com | validation | error | config, database, env, cli, postgres |
| server startup configuration is invalid: - ${line} | validation | error | config, startup, validation, docker, database, redis |
| Worker API error (${response.status}): ${errorText} | exception | error | mcp, worker, http, transport |
transport ${toolName} requires CLAUDE_MEM_RUNTIME=server. Current runtime is "worker"; use | error_code | error | mcp, runtime, config, server-mode |
missing_api_key ${toolName}: ${resolution.reason} | error_code | error | mcp, runtime, config, server-mode, auth |
| observation_add: "content" is required | validation | error | mcp, validation, observation-tools |
| observation_record_event: "eventType" is required | validation | error | mcp, validation, observation-tools, events |
| observation_search: "query" is required | validation | error | mcp, validation, observation-tools, search |
| observation_context: "query" is required | validation | error | mcp, validation, observation-tools, context |
| observation_generation_status: "jobId" is required | validation | error | mcp, validation, observation-tools, jobs |
| Missing required argument: name | validation | error | mcp, validation, corpus |
| Unknown tool: ${request.params.name} | exception | error | mcp, protocol, tool-routing |
| Invalid mode inheritance: ${modeId}. Only one level of inher | validation | error | modes, validation, config |
| Invalid mode ID: ${modeId} | validation | error | modes, validation, config |
| Mode file not found: ${modeId}.json (searched: ${this.modeDi | exception | error | modes, filesystem, config |
| Critical: code.json mode file missing | exception | critical | modes, filesystem, bootstrap, critical |
| Cannot bootstrap server API key: CLAUDE_MEM_SERVER_DATABASE_ | validation | critical | server-mode, config, database, bootstrap |
invalid_response sessionId is required for endSession | error_code | error | server-mode, validation, sessions, server-client |
missing_api_key Server API key is not configured (CLAUDE_MEM_SERVER_API_KEY). | error_code | error | config, authentication, server-client, env-vars, fallback-eligible |
timeout|transport Server ${method} ${path} failed: ${message} | error_code | error | network, transport, timeout, server-client, fallback-eligible |
http_error Server ${method} ${path} returned ${response.status}: ${truncate(text, 200)} | error_code | error | http, server-client, authentication, rate-limiting, conditionally-fallback-eligible |
| Corrupt JSON in ${GEMINI_SETTINGS_PATH}, refusing to overwri | exception | error | config, json, filesystem, antigravity, gemini, installer |
| MCP server script not found | exception | error | installer, filesystem, mcp, antigravity, plugin-layout |
| Codex marketplace root ${resolved} is missing required files | exception | error | installer, codex, filesystem, plugin-layout, validation |
| Could not locate a Codex marketplace root with .agents/plugi | exception | error | installer, codex, filesystem, env-vars, plugin-layout |
| codex ${args.join(' ')} failed with exit code ${exitCode}${s | exception | error | codex, cli, installer, process, subprocess |
| Codex CLI ${version} is too old for plugin marketplace suppo | exception | error | codex, version, installer, cli, upgrade |
| Found mcpServers/claude-mem markers but could not locate a r | exception | error | goose, yaml, config, installer, mcp |
| Telegram API responded ${status} ${statusText} | exception | warning | telegram, notifications, http, config, external-api |
| Corrupt hooks.json at ${WINDSURF_HOOKS_JSON_PATH}, refusing | exception | error | config, json, filesystem, windsurf, installer |
INVALID_SEARCH_REQUEST Either query or filters required for search | validation | warning | search, validation, sqlite, input-validation, session-search |
| chroma-mcp connection in backoff (${Math.ceil((RECONNECT_BAC | exception | warning | chroma, backoff, transient, vector-search, rate-limiting |
| uvx executable not found for chroma-mcp (${uvxSpawnCommand}) | exception | error | chroma, uvx, dependency, vector-search, filesystem, path |
| Unable to acquire Chroma writer lock at ${lockPath}: ${error | exception | error | chroma, filesystem, permissions, lock, vector-search, disk |
| Chroma writer lock at ${lockPath} is unreadable; refusing to | exception | error | chroma, filesystem, lock, corruption, vector-search |
| Unable to remove stale Chroma writer lock at ${lockPath}: ${ | exception | error | chroma, filesystem, lock, permissions, vector-search |
| Chroma data dir ${normalizedDataDir} is already owned by PID | exception | error | chroma, lock, concurrency, single-writer, vector-search |
| Unable to acquire Chroma writer lock at ${lockPath} after re | exception | error | chroma, lock, concurrency, race-condition, vector-search |
| chroma-mcp prewarm failed: ${errorMessage} | exception | error | chroma, uvx, subprocess, prewarm, python, vector-search |
| chroma-mcp transport error during "${toolName}" (retry faile | exception | error | chroma, mcp, transport, subprocess, retry, vector-search |
| chroma-mcp tool "${toolName}" returned error: ${errorText} | exception | error | chroma, mcp, tool-error, validation, vector-search |
| Chroma mutation queue is full (${this.pendingMutationCalls}/ | exception | warning | chroma, mutation-queue, backpressure, backfill, vector-search |
| Backfill failed: ${error instanceof Error ? error.message : | exception | error | chroma, backfill, sync, vector-search |
| Chroma query failed - connection lost: ${errorMessage} | exception | error | chroma, connection, query, transient, vector-search |
| sync hub status ${response.status}: ${body} | exception | error | cloud-sync, http, hub, auth, network |
| sync hub status: response is not JSON | exception | error | cloud-sync, http, json, hub, protocol |
| sync hub status: response must be an object | exception | error | cloud-sync, json, hub, protocol, validation |
| sync hub status: response requires protocol_version 2 | exception | error | cloud-sync, hub, protocol-version, version-skew |
| sync hub status: response requires decimal-string epoch/head | exception | error | cloud-sync, hub, serialization, decimal-string, protocol |
| sync hub status: projected_seq exceeds head_seq | exception | error | cloud-sync, hub, invariant, sequence, corruption |
| sync hub push invariant: request exceeds ${MAX_BODY_BYTES} e | exception | error | cloud-sync, push, invariant, payload-size, batching |
| sync hub push ${res.status}: ${body} | exception | error | cloud-sync, push, http, hub, auth |
| sync hub push: response is not JSON | exception | error | cloud-sync, push, json, hub, protocol |
| sync hub push: response missing acked array | exception | error | cloud-sync, push, hub, protocol, validation |
| sync hub push: response requires decimal-string head_seq/pro | exception | error | cloud-sync, push, hub, serialization, decimal-string |
| sync hub push: acked[${index}] must be an object | exception | error | sync, cloud-sync, hub-response, validation, wire-contract |
| sync hub push: malformed acked[${index}] | exception | error | sync, cloud-sync, hub-response, validation, wire-contract |
| sync hub push: 200 response contains an extra or mismatched | exception | error | sync, cloud-sync, hub-response, validation, tuple-identity |
| sync hub push: duplicate operation tuple claimed different s | exception | error | sync, cloud-sync, hub-response, validation, sequence-integrity |
| sync hub push: distinct operation tuples claimed the same se | exception | error | sync, cloud-sync, hub-response, validation, sequence-integrity |
| sync hub push: 200 response acknowledgment multiplicity mism | exception | error | sync, cloud-sync, hub-response, validation, multiset |
| sync hub push: 200 response acknowledgment multiset mismatch | exception | error | sync, cloud-sync, hub-response, validation, defensive, unreachable |
| sync hub push: checkpoint order requires head_seq <= project | exception | error | sync, cloud-sync, hub-response, validation, checkpoint |
| sync hub push: acknowledgment seq exceeds head_seq | exception | error | sync, cloud-sync, hub-response, validation, checkpoint, sequence-integrity |
| sync hub push: sent operation is not covered by projected_se | exception | error | sync, cloud-sync, hub-response, validation, checkpoint, sequence-integrity |
| cloud sync ack conflict for ${body.id} rev ${body.entity_rev | exception | critical | sync, cloud-sync, data-integrity, conflict, content-addressed |
| SyncApply: sequence gap (expected ${incrementCanonicalDecima | exception | error | sync, sync-apply, validation, sequence-integrity, pagination |
| SyncApply: ops out of order (seq ${op.seq} after ${lastSeq}) | exception | error | sync, sync-apply, validation, sequence-integrity |
| SyncApply: could not create or adopt a session for memory_se | exception | error | sync, sync-apply, database, constraint, session-resolution |
| SyncClient requires a non-empty hubUrl (CLAUDE_MEM_CLOUD_SYN | exception | error | sync, sync-client, config, environment, startup |
| Transcript watch config not found: ${resolvedPath} | exception | error | transcripts, config, filesystem, startup, onboarding |
| Invalid transcript watch config: ${resolvedPath} | exception | error | transcripts, config, validation, schema |
| ingestObservation failed: ${result.reason} | exception | error | transcripts, ingest, observation, database, worker |
| Invalid API key: check your API key configuration in ~/.clau | exception | critical | worker, claude-provider, auth, api-key, configuration |
| Session ${sessionDbId} not found | exception | error | worker, database, session, not-found, validation |
| Cannot process observations: memorySessionId not yet capture | exception | error | session-state, worker, openai-provider, initialization |
| Cannot process summary: memorySessionId not yet captured. Th | exception | error | session-state, worker, openai-provider, summarization, initialization |
| Viewer UI not found at any expected location | http | error | http, viewer, build-artifact, packaging, routes |
INVALID_CORPUS_NAME Invalid corpus name: only alphanumeric characters, dots, hyphens, and underscore | validation | warning | validation, corpus, input-sanitization, http-400 |
| Failed to capture session_id while priming corpus "${corpus. | exception | error | knowledge-agent, claude-sdk, session, prime, auth |
| Corpus "${corpus.name}" has no session — call prime first | exception | error | knowledge-agent, corpus, session, contract-violation |
| Auto-reprime failed for corpus "${corpus.name}" | exception | error | knowledge-agent, corpus, session, recovery, concurrency |
CHROMA_UNAVAILABLE Chroma query failed: ${errorObj.message} | http | error | search, chroma, semantic-search, http-503, fallback |
| CLAUDE_CODE_PATH is set to "${settings.CLAUDE_CODE_PATH}" bu | exception | error | config, claude-cli, path-resolution, settings |
| CLAUDE_CODE_PATH is set to "${settings.CLAUDE_CODE_PATH}" ($ | exception | error | config, claude-cli, version-compat, settings |
| Found desktop app at "${settings.CLAUDE_CODE_PATH}" but it d | exception | error | config, claude-cli, desktop-app, headless, settings |
| CLAUDE_CODE_PATH is set to "${settings.CLAUDE_CODE_PATH}" bu | exception | error | config, claude-cli, path-resolution, probe-failure, settings |
| Every Claude CLI found is too old for claude-mem (each rejec | exception | critical | claude-cli, version-compat, path-resolution, environment |
| Claude executable not found. Please either: 1. Add "claude" | exception | critical | claude-cli, environment, path-resolution, missing-dependency |
| mcp-server.cjs not found in plugin/scripts | exception | error | mcp, plugin, build-artifact, path-resolution |
| Request timed out after ${timeoutMs}ms | exception | warning | network, timeout, fetch, worker, retryable |
| Postgres requires CLAUDE_MEM_SERVER_DATABASE_URL | exception | critical | postgres, config, environment, secrets, database |
| observation generation job status transition was not applied | exception | error | postgres, jobs, state-machine, concurrency, database |
| agent_event source_id must belong to project_id and team_id | validation | error | postgres, jobs, tenancy, validation, ownership, database |
| server_session_id must match the agent_event server_session_ | validation | error | postgres, validation, multi-tenant, ownership, generation-jobs |
| session_summary source_id must equal server_session_id | validation | error | postgres, validation, multi-tenant, generation-jobs |
| observation_reindex source_id must belong to project_id and | validation | error | postgres, validation, multi-tenant, ownership, generation-jobs |
| generation_job_id must belong to project_id and team_id | validation | error | postgres, validation, multi-tenant, generation-jobs, events |
| cannot transition observation generation job from terminal s | validation | error | postgres, state-machine, generation-jobs, validation |
| illegal observation generation job transition from ${current | validation | error | postgres, state-machine, generation-jobs, validation |
| cannot process observation generation job after max_attempts | validation | error | postgres, state-machine, generation-jobs, validation, retry |
| cannot retry observation generation job after max_attempts i | validation | error | postgres, state-machine, generation-jobs, validation, retry |
| observation_id does not exist | validation | error | postgres, validation, multi-tenant, ownership, observations |
| agent_event source_id must equal agent_event_id | validation | error | postgres, validation, observations, invariant |
| generation_job_id must belong to project_id and team_id | validation | error | postgres, validation, multi-tenant, ownership, observations |
| manual observation sources cannot be linked to a generation_ | validation | error | postgres, validation, observations, invariant |
| generation_job_id source model must match observation source | validation | error | postgres, validation, observations, invariant |
| generation_job_id agent_event_id must match observation sour | validation | error | postgres, validation, observations, invariant |
| agent_event_id must belong to project_id and team_id | validation | error | postgres, validation, multi-tenant, ownership, observations |
| observation_reindex source_id must belong to project_id and | validation | error | postgres, validation, multi-tenant, ownership, observations |
| Postgres requires CLAUDE_MEM_SERVER_DATABASE_URL | exception | critical | postgres, config, env, startup, database |
| project_id must belong to team_id | validation | error | postgres, validation, multi-tenant, ownership, tenancy |
| server_session_id must belong to project_id and team_id | validation | error | postgres, validation, multi-tenant, ownership, sessions |
| Worker already running | exception | error | |
| Supervisor is shutting down, refusing to spawn ${type} | exception | error | |
| Hard cap exceeded: ${activeCount} processes in registry (cap | exception | error | |
| Failed to spawn SDK subprocess for session ${sessionDbId} | exception | error | |
| Failed to load ${dataType}: ${response.statusText} | exception | error | |
| Failed to load settings (${res.status}) | exception | error | |
| Corrupt JSON file, refusing to overwrite: ${filePath}: ${err | exception | error | |
| push ${res.status}: ${(await res.text().catch(() => "")).sli | exception | error | |
| push response did not ack the canary op | exception | error | |
| pull ${res.status}: ${(await res.text().catch(() => "")).sli | exception | error | |
| canonical content: ${message} | validation | error | |
| origin_device_id does not match authenticated X-Device-Id | validation | error |