state-trace

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

stdiocommunityinfra

Package Details

state-trace

0.3.1•https://pypi.org/project/state-trace

Transportstdio

Runtime Arguments

Named

extras

[mcp]Install with the [mcp] extra to pull the mcp SDK alongside state-trace.

Environment Variables

STATE_TRACE_STORAGE_PATH(str)

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(str)

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

STATE_TRACE_CAPACITY_LIMIT(num)

Working-memory budget in capacity units. Default 256.