samskriti-shared-layer

Ein lokaler MCP-Server, der es mehreren KI-Codierungstools ermöglicht, strukturierten Projektzustand zu teilen — Entscheidungen, Aufgaben, Bugs — damit sie koordinieren, ohne sich alles neu erklären zu müssen.

   Claude Code      Cursor        Codex
       │              │             │
       │  read/write  │  read/write │
       └──────────────┼─────────────┘
                      ▼
            ┌───────────────────────┐
            │   samskriti-shared-layer   │   (local MCP server, stdio)
            └───────────┬───────────┘
                        ▼
              ┌───────────────────┐
              │   SQLite store    │   ~/.samskriti/  (100% local)
              └───────────────────┘

Das Problem

Du triffst mit einem KI-Tool eine Entscheidung, wechselst dann zu einem anderen und musst alles von Grund auf neu erklären. Jeder Assistent startet ohne Vorwissen und hat keine Ahnung, was bereits entschieden, versucht oder verworfen wurde. Dieser Server gibt ihnen ein gemeinsames, strukturiertes Projekt-Ledger, sodass jedes Tool lesen kann, was die anderen geschrieben haben.

Related MCP server: kb

Installation

Installiere mit pipx (empfohlen — das legt den Befehl samskriti-shared-layer auf deinen PATH, damit deine KI-Tools ihn finden):

pipx install git+https://github.com/Escalate17/samskriti-shared-layer

Du hast kein pipx? Installiere es zuerst: python3 -m pip install --user pipx && python3 -m pipx ensurepath (starte danach dein Terminal neu).

Um zu überprüfen, ob die Installation funktioniert hat:

samskriti-shared-layer --help

Wenn du den Hilfetext siehst, ist alles bereit zum Verbinden.

Verbinden

Am einfachsten: Das Tool für dich konfigurieren lassen

samskriti-shared-layer setup          # Claude Code
samskriti-shared-layer setup --cursor # Cursor
samskriti-shared-layer setup --codex  # Codex
samskriti-shared-layer setup --all    # all three

Das schreibt den MCP-Konfigurationsblock für dich in die richtige Datei (mit einer Sicherung der vorhandenen Konfiguration), sodass du kein JSON von Hand bearbeiten musst. Beende dein Tool danach vollständig und öffne es neu — MCP-Server werden nur beim Start des Tools geladen; eine laufende Sitzung sieht sie also erst nach dem Neustart.

Oder manuell hinzufügen

Füge den Server zur MCP-Konfiguration deines KI-Tools hinzu und starte das Tool danach vollständig neu.

Claude Code (~/.claude.json):

{
  "mcpServers": {
    "samskriti-shared-layer": {
      "command": "samskriti-shared-layer",
      "args": []
    }
  }
}

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "samskriti-shared-layer": {
      "command": "samskriti-shared-layer",
      "args": []
    }
  }
}

Codex (~/.codex/config.toml):

[mcp_servers.samskriti-shared-layer]
command = "samskriti-shared-layer"
args = []

Wenn dein Tool den Befehl nicht finden kann, ist es ein PATH-Problem — führe which samskriti-shared-layer aus, um den vollständigen Pfad zu erhalten, und verwende diesen vollständigen Pfad als Wert für command.

Prüfen, ob die Verbindung steht

In Claude Code tippst du /mcp ein — du solltest samskriti-shared-layer mit seinen 8 Tools aufgelistet sehen. (Cursor und Codex haben ähnliche MCP-Statusanzeigen in ihren Einstellungen.)

Tools

• record_project_entry — speichert einen Eintrag (Ziel, Update, Entscheidung, Konvention, Bug, Aufgabe, verworfene Idee).

• get_project_state — liest eine lesbare Zusammenfassung, gruppiert nach Kategorie.

• search_project_state — Stichwortsuche über alle Einträge.

• update_project_entry — bearbeitet Titel, Inhalt oder Status eines Eintrags.

• list_projects — listet alle verfolgten Projekte auf.

Plus drei Abkürzungen — catchup, open und log — für die häufigsten Aktionen. Siehe Hilfsbefehle unten.

Bereits installiert? Führe pipx reinstall samskriti-shared-layer aus, um die neuen Befehle zu erhalten. Wenn du eine frühere Version installiert hast (sie erscheint als samskriti-shared-layer-local in pipx list), migriere einmal: pipx uninstall samskriti-shared-layer-local && pipx install git+https://github.com/Escalate17/samskriti-shared-layer.

Schneller Zugriff: ein /sam-Slash-Befehl

Jedes Mal „Verwende den samskriti-shared-layer-MCP …“ zu tippen, ist mühsam. Sowohl Claude Code als auch Cursor unterstützen benutzerdefinierte Slash-Befehle — Markdown-Prompt-Dateien, die du in einen Ordner legst. Sie binden nicht direkt an ein Tool, sondern injizieren einen Prompt, der den Agenten anweist, diesen Server zu verwenden, sodass /sam <message> das Richtige tut. (Codex hat keinen Slash-Command-Mechanismus für MCP; sag einfach „Verwende samskriti-shared-layer, um …“ — der Agent wählt das Tool aus.)

Claude Code — speichere slash-commands/claude-code/sam.md in einem der folgenden Ordner:

• ~/.claude/commands/sam.md (in jedem Projekt verfügbar), oder

• <your-project>/.claude/commands/sam.md (nur für dieses Projekt).

Danach in Claude Code: /sam what's open oder /sam log we're dropping the Redis cache. Der $ARGUMENTS-Platzhalter in der Datei empfängt alles, was du nach /sam tippst.

Cursor (1.6+) — speichere slash-commands/cursor/sam.md in:

• ~/.cursor/commands/sam.md (global), oder

• <your-project>/.cursor/commands/sam.md (nur für dieses Projekt).

Tippe dann in Cursors Agent-Box / ein, wähle sam und füge deine Nachricht hinzu.

Noch keine echte Client-Funktion bindet einen Slash-Befehl direkt an einen MCP-Aufruf — diese Befehlsdatei ist die nächste unterstützte Entsprechung, und sie funktioniert heute.

Hilfsbefehle

Drei Abkürzungen fassen die häufigsten Aktionen zusammen. Du rufst sie nie direkt über den Tool-Namen auf — du löst sie mit /sam plus normaler Sprache aus, oder indem du einfach in normaler Sprache fragst.

Zwei Aufrufmöglichkeiten — beide funktionieren:

1. /sam-Slash-Befehl (Claude Code / Cursor, sobald du die obige Befehlsdatei hinzugefügt hast):

   /sam catch me up
   /sam what's open
   /sam log we're switching local storage to SQLite

   Du tippst /sam gefolgt von normaler Sprache. Es gibt keinen eigenständigen /catchup-, /open- oder /log-Befehl — es ist immer /sam plus das, was du möchtest.

2. Normale Sprache (funktioniert in jedem MCP-Tool, einschließlich Codex):

   use samskriti-shared-layer to catch me up
   use samskriti-shared-layer to show what's open
   use samskriti-shared-layer to log: we're switching local storage to SQLite

In 30 Sekunden ausprobieren

1. In Tool A (z. B. Claude Code): „Zeichne eine Entscheidung im Projekt ‚demo‘ auf: Wir verwenden SQLite für die lokale Speicherung.“

2. In Tool B (z. B. Cursor): „Rufe den Projektzustand für ‚demo‘ ab.“

Tool B liest die Entscheidung, die Tool A gerade geschrieben hat — ohne erneutes Erklären.

Demo

Datenschutz

100 % lokal. Keine Cloud, kein Konto, deine Daten verlassen niemals deinen Rechner. Der Zustand wird in einer SQLite-Datenbank unter ~/.samskriti/ gespeichert (überschreibbar mit der Umgebungsvariable SAMSKRITI_HOME oder SAMSKRITI_PROJECT_DB). Die eigenen Daten- und Datenschutzrichtlinien deines KI-Clients gelten weiterhin.

Wie das hier zusammenpasst

Das ist eines von drei Dingen, die ich unter dem Namen Samskriti pflege, und sie teilen eine Prämisse: der Zustand, der zählt, sollte explizit berechnet und gespeichert werden, statt jedes Mal aus einem Transkript rekonstruiert zu werden.

• samskriti — eine Engine, die den emotionalen und relationalen Zustand eines Agenten aus dem, was er erlebt hat, deterministisch und außerhalb jedes Sprachmodells berechnet. C++ mit einem Python-SDK. (Paper)

• samskriti-luau — dasselbe Modell für Roblox, wo NPCs sich merken, wie ein Spieler sie behandelt hat.

• samskriti-shared-layer — dieses Repo. Dieselbe Idee, angewendet auf dein Projekt statt auf einen Charakter: Entscheidungen, Aufgaben und verworfene Ideen leben in einem strukturierten Ledger, das jedes Tool lesen kann, statt in jeder Sitzung neu aus dem Kontext abgeleitet zu werden.

Ein KI-Assistent, der kalt in deiner Codebasis startet, und eine Spielfigur, die vergisst, dass du sie letzte Woche ausgeraubt hast, sind derselbe Fehler. Beide bitten ein Modell, einen Zustand zu rekonstruieren, der ihm nie gegeben wurde. Dieser Server ist die unglamouröse Version der Lösung — und die, die ich jeden Tag benutze.

Status

Frühphase / Validierung. Das ist ein funktionierender Prototyp, der mit echten Workflows getestet wird. Fehler, raue Kanten und fehlende Funktionen sind zu erwarten — Issues und Feedback sind sehr willkommen.

Lizenz

MIT — siehe LICENSE.