Insitu

Ситуативная идентичность для агентов. Кто вы здесь.

Insitu хранит многократно используемые стансы (разделы постоянных инструкций) и собирает их в протокол для проекта, в котором вы находитесь. materialize записывает этот протокол в файлы, которые хост уже внедряет при старте сессии. Вы создаёте контент с помощью list_stanzas и сводок по размерам. Агенты используют resolve_protocol для просмотра и получения стансов с пометкой available.

Он не моделирует репозитории, компоненты или системные факты. Это инструмент контекста разработки (ContextForge в эталонной конфигурации). Эти два инструмента должны работать бок о бок.

Статус

Дизайн зафиксирован 2026-08-17 (DESIGN.md v0.5). Путь чтения, роли (§6.1), validate / where_used и materialize реализованы. Инструменты изменений ждут окончания первого догфудинга. Актуальный следующий шаг: STATUS.md.

Установка

Требуются Python 3.11+ и uv.

cd insitu
uv sync
uv run pytest
uv run insitu

uv run insitu запускает MCP-сервер на stdio.

Корень хранилища

Одно хранилище на процесс, в этом порядке:

1. INSITU_HOME

2. --vault /path/to/vault

3. ~/.insitu

Новое хранилище — это просто папки на диске (stanzas/, projects/, опциональный config/surfaces.yaml). examples/vault/ в этом репозитории — вымышленный пример, на который можно указать:

uv run insitu --vault examples/vault

Не копируйте личное хранилище в этот публичный репозиторий.

Добавьте MCP-сервер в хост

См. install/mcp.json.examples.md с фрагментами для Cursor, Claude Code и Grok. Типичный вид:

{
  "mcpServers": {
    "insitu": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/insitu", "insitu"],
      "env": { "INSITU_HOME": "/path/to/your/vault" }
    }
  }
}

Скопируйте три маршрутизатора (один раз, глобально для пользователя)

Маршрутизаторы сообщают хосту, что Insitu существует. Они не являются проектным протоколом.

Опционально: вставьте install/AGENTS.md в файл конституции вручную. materialize никогда не записывает AGENTS.md, CLAUDE.md или CLAUDE.local.md.

Включите адаптеры хостов в хранилище с помощью config/surfaces.yaml (grok, claude, cursor). Затем из рабочей копии проекта вызовите materialize. Он запишет PROTOCOL.md и файлы адаптеров в .grok/rules/, .claude/rules/ и .cursor/rules/.

Целевое использование

# you, after a vault or map change
materialize               # PROTOCOL.md + host adapters (.grok/.claude/.cursor rules)

# agent, live / on demand
resolve_protocol          # inspect weight, refresh, compare to the materialized header
get_stanza ...            # pull an available stanza

# you, registering a new project
list_stanzas              # what exists, and how heavy each piece is
link_stanza ...           # after the write path exists
get_project               # how heavy is this project's protocol?

Разработка

uv sync
uv run pytest
uv run insitu

Python 3.11+, FastMCP. Смотрите AGENTS.md, если вы агент, работающий в этом репозитории.

Лицензия

MIT. Смотрите LICENSE.