state-trace

io.github.razroo/state-trace·v0.3.1·Memory & RAG

Quality Score

/100

Bounded working memory for coding agents — typed nodes, current-vs-stale state, MCP-mountable.

Repository →

§01 Install

Claude Desktop (uvx)

{
  "mcpServers": {
    "state-trace": {
      "command": "uvx",
      "args": [
        "state-trace"
      ],
      "env": {
        "STATE_TRACE_STORAGE_PATH": "<state_trace_storage_path>",
        "STATE_TRACE_NAMESPACE": "<state_trace_namespace>",
        "STATE_TRACE_CAPACITY_LIMIT": "<state_trace_capacity_limit>"
      }
    }
  }
}

§02 Environment variables

STATE_TRACE_STORAGE_PATH

Path to the SQLite or JSON file backing the working-memory graph. .db/.sqlite/.sqlite3 = SQLite (recommended); other = JSON. Defaults to ~/.state-trace/memory.db.

STATE_TRACE_NAMESPACE

Namespace to scope reads and writes (e.g. the repo slug). Nodes without a namespace remain visible to all namespaces.

STATE_TRACE_CAPACITY_LIMIT

Working-memory budget in capacity units. Default 256.

§03 MCP Quality Score · methodology

freshness

completeness

installability

documentation

stability

§04 Alternatives in Memory & RAG

DoneThat