Insitu

Situierte Identität für Agenten. Wer du hier bist.

Insitu speichert wiederverwendbare Strophen (Abschnitte von dauerhafter Anleitung) und fügt sie zu einem Protokoll für das Projekt zusammen, in dem du gerade stehst. materialize schreibt dieses Protokoll in Dateien, die der Host bereits beim Sitzungsstart injiziert. Du arbeitest mit list_stanzas und den Größenübersichten. Agenten verwenden resolve_protocol, um das Protokoll zu prüfen und available Strophen abzurufen.

Es modelliert keine Repos, Komponenten oder Systemfakten. Das ist ein Dev-Kontext-Tool (ContextForge, im Referenz-Setup). Die beiden sollen nebeneinander laufen.

Status

Design eingefroren am 2026-08-17 (DESIGN.md v0.5). Der Lesepfad, Rollen (§6.1), validate / where_used und materialize sind implementiert. Mutationswerkzeuge warten bis nach dem ersten Dogfooding. Aktueller nächster Schritt: STATUS.md.

Installation

Erfordert Python 3.11+ und uv.

cd insitu
uv sync
uv run pytest
uv run insitu

uv run insitu startet den MCP-Server auf stdio.

Vault-Wurzel

Ein Vault pro Prozess, in dieser Reihenfolge:

1. INSITU_HOME

2. --vault /path/to/vault

3. ~/.insitu

Ein frisches Vault ist nur Ordner auf der Festplatte (stanzas/, projects/, optional config/surfaces.yaml). examples/vault/ in diesem Repo ist ein fiktives Beispiel, auf das du verweisen kannst:

uv run insitu --vault examples/vault

Kopiere kein persönliches Vault in dieses öffentliche Repo.

MCP-Server zu einem Host hinzufügen

Siehe install/mcp.json.examples.md für Snippets für Cursor, Claude Code und Grok. Typische Form:

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

Kopiere die drei Router (einmal, benutzerglobal)

Router teilen dem Host mit, dass Insitu existiert. Sie sind nicht das Projektprotokoll.

Optional: Füge install/AGENTS.md von Hand in eine Verfassungsdatei ein. materialize schreibt nie AGENTS.md, CLAUDE.md oder CLAUDE.local.md.

Aktiviere Host-Adapter im Vault mit config/surfaces.yaml (grok, claude, cursor). Rufe dann aus einem Projekt-Checkout materialize auf. Das schreibt PROTOCOL.md sowie die Adapterdateien unter .grok/rules/, .claude/rules/ und .cursor/rules/.

Verwendungszweck

# 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?

Entwickeln

uv sync
uv run pytest
uv run insitu

Python 3.11+, FastMCP. Siehe AGENTS.md, wenn du ein Agent bist, der in diesem Repo arbeitet.

Lizenz

MIT. Siehe LICENSE.