decisionnode/DecisionNode

npm install -g decisionnode
cd your-project && decide init
decide setup
claude mcp add decisionnode -s user decide-mcp

Usage

• •decide add -s Backend -d "..." to record a decision
• •decide search "connection pooling" for semantic search
• •AI calls add_decision / search_decisions via MCP to read and write decisions
• •decide ui launches a local web UI with graph, vector space and list views

Key features

• ✓Decisions stored as JSON, embedded with Gemini embeddings and searched by cosine similarity
• ✓Explicit retrieval via MCP search_decisions; nothing pre-injected into the system prompt
• ✓History tracking, 75% similarity conflict detection, deprecate/activate soft-delete
• ✓Global decisions shared across all projects and configurable search threshold
• ✓Local web UI with force-directed graph and UMAP vector-space projection

Best for

Teams that want AI agents to recall past architecture decisions through semantic memory instead of context-window rules.

Caveats

• ⚠Requires a Gemini API key for embedding generation
• ⚠Decisions are only pulled in when the AI explicitly searches, so they can be missed