samskriti-shared-layer

複数のAIコーディングツールが構造化されたプロジェクト状態（決定事項、タスク、バグ）を共有できるようにするローカルMCPサーバーです。これにより、毎回説明し直すことなくツール間で連携できます。

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

問題

あるAIツールで決定を下しても、別のツールに切り替えると最初からすべてを説明し直さなければなりません。各アシスタントは、何がすでに決定され、試され、却下されたのかを知らないまま、まっさらな状態で始まります。このサーバーは、プロジェクトの共有・構造化台帳をツール群に提供し、どのツールも他のツールが書き込んだ内容を読めるようにします。

Related MCP server: kb

インストール

pipx でインストールします（推奨 — これにより samskriti-shared-layer コマンドが PATH に追加され、AIツールから見つけられるようになります）：

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

pipx をお持ちでない場合は、先にインストールしてください：python3 -m pip install --user pipx && python3 -m pipx ensurepath（その後、ターミナルを再起動してください）。

インストールが成功したことを確認するには：

samskriti-shared-layer --help

ヘルプテキストが表示されれば、接続の準備は完了です。

接続

最も簡単な方法：ツールに自動設定させる

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

これにより、MCP設定ブロックが自動的に適切なファイルに書き込まれます（既存の設定は最初にバックアップされます）。JSONを手作業で編集する必要はありません。その後、ツールを完全に終了して開き直してください — MCPサーバーはツールの起動時にのみ読み込まれるため、再起動するまで実行中のセッションには反映されません。

または手動で追加する

サーバーをAIツールのMCP設定に追加し、ツールを完全に再起動してください。

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 = []

ツールがコマンドを見つけられない場合は、PATHの問題です — which samskriti-shared-layer を実行してフルパスを取得し、そのフルパスを command の値として使ってください。

接続を確認する

Claude Code で /mcp と入力すると、samskriti-shared-layer がその8つのツールとともに一覧表示されるはずです。（Cursor と Codex にも、設定内に同様のMCPステータス表示があります。）

ツール

• record_project_entry — エントリ（goal、update、decision、convention、bug、task、rejected_idea）を保存します。

• get_project_state — カテゴリ別にグループ化された読みやすい要約を取得します。

• search_project_state — エントリ全体に対するキーワード検索。

• update_project_entry — エントリのタイトル、内容、ステータスを編集します。

• list_projects — 追跡中のすべてのプロジェクトを一覧表示します。

さらに、最も一般的な操作のための3つのショートカット — catchup、open、log — があります。以下のヘルパーコマンドを参照してください。

すでにインストール済みですか？ 新しいコマンドを反映するには pipx reinstall samskriti-shared-layer を実行してください。 以前のビルドをインストールしている場合（pipx list に samskriti-shared-layer-local と表示されます）、一度移行してください：pipx uninstall samskriti-shared-layer-local && pipx install git+https://github.com/Escalate17/samskriti-shared-layer。

より素早く使う：/sam スラッシュコマンド

毎回 「samskriti-shared-layer MCPを使って…」 と入力するのは面倒です。Claude Code と Cursor はどちらもカスタムスラッシュコマンドをサポートしています — フォルダに置くMarkdownプロンプトファイルです。これらはツールに直接バインドされるわけではありませんが、このサーバーを使うようエージェントに指示するプロンプトを注入するため、/sam <message> で意図した動作が行われます。（Codex にはMCP向けのスラッシュコマンド機能がありません。「samskriti-shared-layerを使って…」 とだけ言えば、エージェントがツールを選択します。）

Claude Code — slash-commands/claude-code/sam.md を次のいずれかに保存してください：

• ~/.claude/commands/sam.md（すべてのプロジェクトで利用可能）、または

• <your-project>/.claude/commands/sam.md（そのプロジェクトのみ）

その後、Claude Code で /sam what's open または /sam log we're dropping the Redis cache のように入力します。ファイル内の $ARGUMENTS プレースホルダーが、/sam の後に入力したすべてのテキストを受け取ります。

Cursor（1.6+）— slash-commands/cursor/sam.md を次のいずれかに保存してください：

• ~/.cursor/commands/sam.md（グローバル）、または

• <your-project>/.cursor/commands/sam.md（そのプロジェクトのみ）

その後、Cursor のエージェントボックスで / と入力し、sam を選択して、メッセージを追加します。

スラッシュコマンドをMCP呼び出しに直接バインドする本格的なクライアント機能はまだありません — このコマンドファイルは、現在サポートされている最も近い代替手段であり、今日から使えます。

ヘルパーコマンド

3つのショートカットは、最も一般的な操作をラップします。ツール名で直接呼び出すことはありません — /sam に平易な言葉を続けるか、単に平易な言葉で依頼するだけです。

呼び出し方は2通り — どちらも機能します：

1. /sam スラッシュコマンド（Claude Code / Cursor。上記のコマンドファイルを追加済みの場合）：

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

   /sam の後に平易な言葉を続けて入力します。単独の /catchup、/open、/log コマンドはありません — 常に /sam とその後にやりたいことを入力します。

2. 平易な言葉（Codex を含むあらゆるMCPツールで機能します）：

   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

30秒で試す

1. ツールA（例：Claude Code）で：「プロジェクト 'demo' に決定を記録してください：ローカルストレージにはSQLiteを使用します。」

2. ツールB（例：Cursor）で：「プロジェクト 'demo' の状態を取得してください。」

ツールBは、ツールAが書いた決定を読み返します — 説明し直す必要はありません。

デモ

プライバシー

100%ローカル。クラウドなし、アカウントなし、あなたのデータがマシンの外に出ることはありません。状態は ~/.samskriti/ 配下のSQLiteデータベースに保存されます（SAMSKRITI_HOME または SAMSKRITI_PROJECT_DB 環境変数で上書きできます）。AIクライアント独自のデータおよびプライバシーポリシーは引き続き適用されます。

位置づけ

これは私が Samskriti という名前で保守している3つのプロジェクトのうちの1つで、共通の前提を共有しています：重要な状態は毎回トランスクリプトから再構築するのではなく、明示的に計算して保存されるべきです。

• samskriti — エージェントが経験したことから、感情状態と関係状態を、言語モデルを使わずに決定的に計算するエンジン。C++ と Python SDK を備えています。（論文）

• samskriti-luau — Roblox 向けの同じモデル。NPCがプレイヤーから受けた扱いを記憶します。

• samskriti-shared-layer — このリポジトリ。同じアイデアをキャラクターではなく あなたの プロジェクトに適用したものです：決定事項、タスク、却下されたアイデアは、セッションごとにコンテキストから再導出されるのではなく、どのツールでも読める構造化台帳に保存されます。

あなたのコードベースを何も知らずに使い始めるAIアシスタントと、先週あなたに盗まれたことを忘れてしまうゲームキャラクターは、同じ失敗です。どちらも、与えられたことのない状態をモデルに再構築させています。このサーバーは、その修正の地味なバージョンであり、私が毎日使っているものです。

ステータス

初期段階 / 検証中。実際のワークフローでテストされている動作するプロトタイプです。バグ、未整備な部分、不足している機能があることは想定されています — 問題報告やフィードバックを大歓迎します。

ライセンス

MIT — LICENSE を参照してください。