AgentMemory for Codex on Windows

Unabhängiger, Windows-nativer AgentMemory-Downstream für OpenAI Codex Desktop und Codex CLI.

English | 한국어 | 日本語

[!WICHTIG] Dies ist eine unabhängige, nur aus Quellcode bestehende technische Vorschau. Sie basiert auf AgentMemory v0.9.29, ist aber nicht das offizielle Upstream-Repository, eine npm-Veröffentlichung von @agentmemory/* oder ein Versprechen auf Upstream-Support. Verwenden Sie keinen Upstream-npx-Befehl oder die Kompatibilitäts-Plugins-Manifeste als Ersatz für den hier beschriebenen Windows-Build und Installer.

Entwicklungshinweis: Dieser Downstream ist KI-generiert und nutzergetestet; lesen Sie die vollständige Offenlegung.

Was diese Vorschau tut

AgentMemory bewahrt nützlichen Kontext über Codex-Aufgaben hinweg auf, während die offiziellen AgentMemory-Speicher für Erinnerungen, Lektionen, Graphen, Audit und Provenienz die einzigen kanonischen Speicher bleiben.

• Erfasst normale Haupt-Agent-Benutzeraufforderungen und endgültige Assistentenantworten über vier verwaltete Codex-Hooks: SessionStart, UserPromptSubmit, Stop und SessionEnd.

• Schließt Umgebungs-UI, Titel-/Fork-Verkehr, bekannte interne Host-Aufforderungen und Subagenten-Verkehr von der dauerhaften Erfassung aus.

• Hält Schreibvorgänge, Löschung, Kuratierung und Provenienz exakt auf Projektebene begrenzt.

• Unterstützt begrenzten, quellenbeschrifteten föderierten Abruf über Projekte hinweg, ohne Wildcard-Schreibvorgänge zu ermöglichen.

• Kann einen anmeldefreien, nur auf Loopback beschränkten lokalen Qwen-Worker für typisierte Graphextraktion verwenden. Jede andere AgentMemory-LLM-Funktion erhält den Noop-Provider; externe Fallbacks bleiben deaktiviert.

• Verwendet einen authentifizierten Loopback-MCP-Endpunkt für Codex und behält einen verpackten Stdio-Launcher nur als Kompatibilitätspfad bei.

Die upstream-kompatible Quelloberfläche enthält 56 MCP-Tools. Ihre MCP-Oberfläche umfasst 56 Tools, 6 Ressourcen und 3 Prompts; sie hat außerdem 133 Endpunkte auf Port 3111, 12 portable Hooks und 17 Skills. Das unterstützte Windows-Profil aktiviert absichtlich nur die vier oben aufgeführten verwalteten Hooks.

Related MCP server: remem

Versionsidentitäten

Das genaue Upstream-Tag, der Commit, der Baum und der unveränderte Paket-Hash sind in upstream-source.json dokumentiert.

Anforderungen

• Windows mit PowerShell 5.1 oder neuer; diese Vorschau ist auf Windows 11 qualifiziert

• Node.js 20 oder neuer

• pnpm 11.19.0 gemäß der festgelegten Paketmanager-Deklaration des Repositories

• Die offizielle iii-Engine 0.11.2 für Windows, deren SHA-256 mit packaging/windows-codex/config/third-party-inputs.json übereinstimmt

An der ersten Quellcode-Vorschau ist kein vorgebauter oder signierter Installateur angebracht.

Aus dem Quellcode erstellen und auswerten

Klonen Sie das Repository unter Windows und führen Sie dann den Release-Builder aus PowerShell aus. Das Ausgabeverzeichnis darf noch nicht existieren.

git clone https://github.com/M-T-D-N/agentmemory-codex-windows.git
Set-Location agentmemory-codex-windows

& .\packaging\windows-codex\Build-WindowsCodex.ps1 `
  -OutputDirectory D:\staging\agentmemory-codex `
  -IiiEnginePath D:\inputs\iii-0.11.2.exe

Der normale Builder verifiziert die festgelegte native Eingabe, stellt den eingefrorenen Lock wieder her, prüft generierte Skills, führt Typüberprüfungen durch, baut, führt die Paket- und Codex-Adapter-Tests aus, erstellt einen Produktionsabhängigkeitsbaum und schreibt ein vollständiges unveränderliches Dateimanifest.

Der Installer ist standardmäßig ein Trockenlauf. Er validiert Release-Hashes, Eigentum, Pfade und die vorhandene Installation, bevor er etwas ändert. Prüfen Sie den genauen Vertrag für Build, Trockenlauf, Umschaltung, Rollback, Aufbewahrung und Authentifizierung in packaging/windows-codex/README.md, bevor Sie -Execute verwenden.

[!WARNUNG] Der Windows-Installer ist für ein eigenes, verwaltetes AgentMemoryCodex-Servicelayout ausgelegt. Richten Sie ihn nicht auf ein nicht zusammenhängendes Verzeichnis und behandeln Sie Build-Ausgaben nicht als Benutzerdaten. Kanonische data-, Geheimnis-, Log-, Aufgabendidentitäts- und Rollback-Zustände haben unabhängige Lebenszyklen.

Datenschutz- und Sicherheitsgrenzen

• MCP- und Dienstdatenverkehr bleiben im unterstützten Profil auf authentifizierten Loopback-Endpunkten.

• Der optionale Qwen-Provider akzeptiert nur anmeldefreies Loopback-HTTP und ist fähigkeitsmäßig auf Graphextraktion beschränkt.

• Der Quellbaum enthält keine Speicherdatenbank, kein Sitzungstranskript, keinen Benutzerexport, keinen API-Schlüssel, keinen generierten Installer und keine private Entwicklungsgeschichte.

• Sicherheitsberichte sollten den privaten Schwachstellenmeldefluss von GitHub verwenden; siehe SECURITY.md.

Repository-Übersicht

Die Upstream-Marketing-Website, Cloud-Bereitstellungsbeispiele, andere Upstream-Sprachkopien, generierte Build-Ausgaben und die private Monorepo-Geschichte liegen absichtlich außerhalb des ersten öffentlichen Repository-Schnappschusses. Historisches Benchmark-Material wird nur aus Reproduzierbarkeitsgründen aufbewahrt und ist ausdrücklich als Upstream-Referenz gekennzeichnet; keine Benchmark-Zahl in diesen Verzeichnissen ist eine Aussage für diese Downstream-Vorschau.

Entwicklungsprüfungen

pnpm install --frozen-lockfile
pnpm run skills:check
pnpm run typecheck
pnpm run build
pnpm test
node packaging/windows-codex/tests/codex-turn.test.mjs

Das Repository ist in Paketmanifesten als private markiert, um eine versehentliche Veröffentlichung unter den Upstream-Paketnamen @agentmemory/* zu verhindern. Beiträge sollten CONTRIBUTING.md folgen, und die Downstream-Release-Geschichte befindet sich in CHANGELOG.md.

Offenlegung der KI-Entwicklung

Die meisten Downstream-Änderungen wurden von OpenAI Codex aus Benutzeranforderungen und iterativen Akzeptanzanfragen generiert und überarbeitet. Der Repository-Besitzer hat den Quellcode nicht manuell überprüft. Die Validierung basiert auf automatisierten Tests und Live-Funktionstests in der Windows-/Codex- Umgebung des Besitzers. Es wurde keine unabhängige Code- oder Sicherheitsüberprüfung durch Dritte durchgeführt.

Kurz gesagt: KI-generiert, nutzergetestet, nicht manuell code-geprüft.

Upstream-Zuschreibung und Lizenz

Dieser Downstream basiert auf AgentMemory von Rohit Ghumare und Mitwirkenden. Siehe NOTICE und upstream-source.json für die Zuschreibung und die genaue Quellidentität. Der Code wird unter der Apache License 2.0 bereitgestellt.