decisionnode/DecisionNode

Record a decision, embed it as a vector, search it later. One store shared across all your AI tools: Claude Code, Cursor, Windsurf, and any MCP client.

Not a markdown file — structured decisions with semantic search, exposed over MCP.

Install

npm install -g decisionnode
cd your-project
decide init      # creates project store
decide setup     # configure Gemini API key (free tier)

# Connect to Claude Code (run once)
claude mcp add decisionnode -s user decide-mcp

How it works

1. A decision is made — via decide add or the AI calls add_decision through MCP

2. Embedded as a vector — using Gemini's gemini-embedding-001, stored locally in vectors.json

3. AI retrieves it later — calls search_decisions via MCP, gets back relevant decisions ranked by cosine similarity

The retrieval is explicit — the AI calls the MCP tool to search. Decisions are not injected into a system prompt.

Two interfaces

Both read and write to the same local store (~/.decisionnode/).

Quick reference

decide add                          # interactive add
decide add -s UI -d "Use Tailwind"  # one-command add
decide add --global                 # applies to all projects
decide search "error handling"      # semantic search
decide list                         # list all (includes global)
decide deprecate ui-003             # soft-delete (reversible)
decide activate ui-003              # bring it back
decide check                        # embedding health
decide embed                        # fix missing embeddings
decide export json > decisions.json # export to file

Features

Documentation

Full docs at decisionnode.dev/docs

• Quickstart

• CLI Reference — all commands

• MCP Server — 9 tools, setup for Claude/Cursor/Windsurf

• Decision Nodes — structure, fields, lifecycle

• Context Engine — embedding, search, conflict detection

• Configuration — storage, agent behavior, search threshold, global decisions

• Workflows — common patterns

For LLM consumption: decisionnode.dev/decisionnode-docs.md

Contributing

See ROADMAP.md for what's coming next. Bug fixes, features, docs improvements, or just ideas are all welcome. See CONTRIBUTING.md for how to get started.

License

MIT — see LICENSE.