decisionnode/DecisionNode

Entscheidungen aufzeichnen, als Vektor einbetten und später durchsuchen. Ein Speicher, der von all Ihren KI-Tools gemeinsam genutzt wird: Claude Code, Cursor, Windsurf und jeder MCP-Client.

Keine Markdown-Datei — strukturierte Entscheidungen mit semantischer Suche, bereitgestellt über MCP.

Installation

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

Funktionsweise

1. Eine Entscheidung wird getroffen — via decide add oder die KI ruft add_decision über MCP auf

2. Als Vektor eingebettet — unter Verwendung von Geminis gemini-embedding-001, lokal gespeichert in vectors.json

3. KI ruft sie später ab — ruft search_decisions über MCP auf und erhält relevante Entscheidungen, sortiert nach Kosinus-Ähnlichkeit

Der Abruf erfolgt explizit — die KI ruft das MCP-Tool zur Suche auf. Entscheidungen werden nicht in einen System-Prompt injiziert.

Zwei Schnittstellen

Beide lesen und schreiben in denselben lokalen Speicher (~/.decisionnode/).

Kurzübersicht

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

Funktionen

Dokumentation

Vollständige Dokumentation unter decisionnode.dev/docs

• Quickstart

• CLI-Referenz — alle Befehle

• MCP-Server — 9 Tools, Setup für Claude/Cursor/Windsurf

• Decision Nodes — Struktur, Felder, Lebenszyklus

• Context Engine — Einbettung, Suche, Konflikterkennung

• Konfiguration — Speicher, Agentenverhalten, Suchschwellenwert, globale Entscheidungen

• Workflows — gängige Muster

Für LLM-Nutzung: decisionnode.dev/decisionnode-docs.md

Mitwirken

Siehe ROADMAP.md für kommende Funktionen. Fehlerbehebungen, neue Features, Verbesserungen der Dokumentation oder einfach nur Ideen sind willkommen. Siehe CONTRIBUTING.md für den Einstieg.

Lizenz

MIT — siehe LICENSE.