samskriti-shared-layer

Локальный MCP-сервер, который позволяет нескольким ИИ-инструментам для разработки совместно использовать структурированное состояние проекта — решения, задачи, баги — чтобы они координировались без повторных объяснений.

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

Проблема

Вы принимаете решение в одном ИИ-инструменте, затем переключаетесь на другой — и приходится объяснять всё заново с нуля. Каждый ассистент стартует «холодным», не имея представления о том, что уже решено, опробовано или отклонено. Этот сервер даёт им общий структурированный реестр вашего проекта, чтобы любой инструмент мог прочитать то, что записали другие.

Related MCP server: kb

Установка

Установите с помощью pipx (рекомендуется — это добавляет команду samskriti-shared-layer в PATH, чтобы ваши ИИ-инструменты могли её найти):

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-серверы загружаются только при запуске инструмента, поэтому текущая сессия не увидит его, пока вы не перезапустите.

Или добавьте вручную

Добавьте сервер в 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 — выводит список всех отслеживаемых проектов.

Плюс три ярлыка — catchup, open и log — для самых частых действий. См. Вспомогательные команды ниже.

Уже установлено? Выполните pipx reinstall samskriti-shared-layer, чтобы получить новые команды. Если вы установили более раннюю сборку (она отображается как samskriti-shared-layer-local в pipx list), выполните миграцию один раз: pipx uninstall samskriti-shared-layer-local && pipx install git+https://github.com/Escalate17/samskriti-shared-layer.

Быстрый доступ: слэш-команда /sam

Каждый раз печатать «используйте MCP samskriti-shared-layer …» утомительно. И 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 — этот файл команды является ближайшим поддерживаемым эквивалентом, и он работает уже сегодня.

Вспомогательные команды

Три ярлыка оборачивают самые частые действия. Вы никогда не вызываете их напрямую по имени инструмента — вы запускаете их с помощью /sam плюс обычный текст, или просто обращаясь обычным языком.

Два способа вызова — оба работают:

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. Обычный язык (работает в любом MCP-инструменте, включая 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

Попробуйте за 30 секунд

1. В инструменте A (например, Claude Code): «Запиши решение в проекте 'demo': мы используем SQLite для локального хранения.»

2. В инструменте B (например, Cursor): «Получи состояние проекта для 'demo'.»

Инструмент B считывает решение, которое только что записал инструмент A, — без повторных объяснений.

Демо

Конфиденциальность

100% локально. Никакого облака, никакого аккаунта, ваши данные никогда не покидают ваш компьютер. Состояние хранится в базе данных SQLite в ~/.samskriti/ (можно переопределить с помощью переменной окружения SAMSKRITI_HOME или SAMSKRITI_PROJECT_DB). Собственные политики обработки данных и конфиденциальности вашего ИИ-клиента по-прежнему применяются.

Как это вписывается

Это одна из трёх вещей, которые я поддерживаю под именем Samskriti, и все они разделяют общую идею: важное состояние должно вычисляться и храниться явно, а не восстанавливаться из транскрипта каждый раз.

• samskriti — движок, который детерминированно вычисляет эмоциональное и реляционное состояние агента на основе его опыта, вне какой-либо языковой модели. C++ с Python SDK. (статья)

• samskriti-luau — та же модель для Roblox, где NPC запоминают, как игрок к ним относился.

• samskriti-shared-layer — этот репозиторий. Та же идея, применённая к вашему проекту, а не к персонажу: решения, задачи и отклонённые идеи хранятся в структурированном реестре, который может прочитать любой инструмент, вместо того чтобы каждый раз заново извлекаться из контекста.

ИИ-ассистент, начинающий холодным на вашей кодовой базе, и игровой персонаж, забывший, что вы ограбили его на прошлой неделе, — это один и тот же сбой. Оба просят модель восстановить состояние, которое ей никогда не передавали. Этот сервер — не самая эффектная версия решения, но именно ею я пользуюсь каждый день.

Статус

Ранняя стадия / проверка. Это рабочий прототип, который тестируется на реальных рабочих процессах. Ожидаются баги, шероховатости и отсутствующие функции — вопросы и обратная связь очень приветствуются.

Лицензия

MIT — см. LICENSE.