Timps

io.github.Sandeeprdy1729Published by GitHub account Sandeeprdy1729v2.0.3Updated Oct 24, 2026

Persistent memory with contradiction detection, burnout monitoring, and 69 intelligence tools.

VerifiedSTDIODesktop onlyKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

A local MCP server that gives coding assistants persistent memory across sessions, with contradiction detection, bug-pattern warnings, decision and burnout tool

What you can do
Store, retrieve and chat over persistent memories, including local file-based storage when no server URL is set. Detect contradictions between new statements and past positions, and log, simulate or review decisions. Warn about known bug patterns, record bugs and incidents, check tech debt and predict bug risk. Track API quirks, meetings and commitments, and people mentioned in conversations. Query causal, knowledge and synapse graphs, check architecture drift and deployment risk, and audit memory provenance and conflicts.
When to use it
Useful when you want an AI coding assistant to remember earlier sessions, flag when a new statement contradicts something said before, or surface past bug patterns and decisions while working in a codebase.
Requirements
Runs locally as an npm package (global install) over stdio. Needs Node.js. Optionally set TIMPS_URL to point at a TIMPS MemoryServer; without it, memory is stored in local files under TIMPS_PROJECT_PATH (defaults to the working directory). TIMPS_API_KEY authenticates with the server and is generated via the server's auth endpoint. TIMPS_USER_ID defaults to 1.
Before you install
The API key (TIMPS_API_KEY) is a secret and should be kept out of shared config. Tools write memory, decisions, incidents and commitments, and in server mode that data is sent to the configured TIMPS_URL endpoint, so point it only at a server you trust. The README's example configs use a local server URL and a default user ID.

Installation

In SourceWeft

  1. Open Timps in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@timps-ai/timps-mcp — Persistent Memory for Claude, Cursor, and Windsurf

[npm] [License: MIT]

45 MCP tools that give your AI coding assistant persistent memory across sessions — contradiction detection, bug patterns, burnout monitoring, architecture drift, and 22-layer memory forge.

bash
npm install -g @timps-ai/timps-mcp

Add to your AI tool

Claude Code (~/.claude.json)

json
{  "mcpServers": {    "timps": {      "command": "timps-mcp",      "env": { "TIMPS_URL": "http://localhost:3000", "TIMPS_USER_ID": "1" }    }  }}

Cursor (~/.cursor/mcp.json)

json
{  "mcpServers": {    "timps": {      "command": "timps-mcp",      "env": { "TIMPS_URL": "http://localhost:3000", "TIMPS_USER_ID": "1" }    }  }}

Windsurf (~/.codeium/windsurf/mcp_config.json)

json
{  "mcpServers": {    "timps": {      "command": "timps-mcp",      "env": { "TIMPS_URL": "http://localhost:3000", "TIMPS_USER_ID": "1" }    }  }}

Two modes

ModeConfigBackend
SERVER (default)TIMPS_URL setProxies to TIMPS HTTP server
LOCALNo TIMPS_URLUses @timps-ai/memory-core MemoryEngine directly

45 MCP Tools

Core Memory

timps_chat, timps_get_memories, timps_store_memory

Contradiction Detection

timps_check_contradiction, timps_get_positions

Decision Intelligence

timps_check_regret, timps_log_decision, timps_simulate_decision, timps_log_past_decision

Burnout Monitoring

timps_burnout_analyze, timps_record_signal

Bug & Code Patterns

timps_warn_bug_pattern, timps_record_bug, timps_check_tech_debt, timps_record_incident

API Knowledge

timps_lookup_api, timps_record_api_quirk

Meetings & Commitments

timps_extract_commitments, timps_get_pending_commitments, timps_complete_commitment

Relationships

timps_record_mention, timps_relationship_check

Living Manifesto

timps_ingest_manifesto_signal, timps_get_manifesto

Chronos Veil (Causal Graph)

timps_chronos_ingest, timps_chronos_query, timps_chronos_stats

NexusForge (Knowledge Graph)

timps_nexus_ingest, timps_nexus_query, timps_nexus_stats, timps_nexus_graph

SynapseMetabolon

timps_synapse_ingest, timps_synapse_query, timps_synapse_stats, timps_synapse_graph, timps_synapse_consolidate

Architecture & Risk

timps_detect_architecture_drift, timps_predict_bug_risk, timps_get_incident_timeline, timps_check_deployment_risk

Developer Intelligence

timps_get_velocity_trend, timps_get_context_switches, timps_record_learning, timps_get_shared_decisions, timps_record_review_pattern

ChronosForge

timps_temporal_query, timps_chrono_foresight, timps_chrono_consolidate

L7+ Intelligence

timps_skill_shadow, timps_log_question, timps_curriculum_plan, timps_observe_culture, timps_codebase_culture, timps_record_contribution, timps_mark_contributor_active, timps_institutional_memory

22-Layer Tools

timps_verify_engram_chain, timps_false_memory_check, timps_explain_provenance, timps_resolve_conflict, timps_audit_memory, timps_register_trigger, timps_reveal_bias, timps_infer_schemas

Env Variables

VariableDefaultDescription
TIMPS_URL—TIMPS server URL (SERVER mode)
TIMPS_USER_ID1User ID

Examples

You: "I'm going to use setTimeout for sync here"→ timps_warn_bug_pattern → ⚠️ Bug pattern match (race condition, hit before in src/queue.ts)
You: "Remote teams don't work"→ timps_check_contradiction → ⚠️ CONTRADICTION 82% — 47 days ago you said "Remote works best"

Source: timps-mcp/README.md at commit 6e17ae9

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v2.0.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts