AI Cloud Memory Community Edition

Ihr eigener gemeinsamer Speicher, Projekt-Board und langfristiger Fahrplan für KI-Clients, der in Ihrem Cloudflare-Konto läuft und über Ihre GitHub-Identität gehört.

AI Cloud Memory bietet Codex, Claude Code, OpenCode und kompatiblen Web-Clients einen authentifizierten MCP-Endpunkt für dauerhafte Speicherung und Projektlebenszyklus-Arbeit. D1 ist kanonisch. Die Suche funktioniert standardmäßig im lexikalischen und temporalen Modus, während Vectorize und Workers AI später für semantische Abfragen und Reranking aktiviert werden können.

Kein n8n, kein Heimserver, kein Anbieterkonto und kein von diesem Projekt betriebener Dienst ist erforderlich. Jeder Anwender stellt eine isolierte Kopie in seinem eigenen Cloudflare- und GitHub-Konto bereit.

Was Sie bekommen

• Nur-Eigentümer-GitHub-OAuth und eingeschränktes MCP-OAuth

• Erinnerungen und dauerhafte Anweisungen mit Herkunft, Labels, Archivierung, Ersetzung und Überprüfung

• Projekte, Kanban-Aufgaben, Abschlussbelege, archivierte Arbeiten und Done-Verlauf

• Langfristige Projekt-Roadmaps mit sicherer Überführung in Aufgaben

• Verarbeitung zeitlicher Abfragen, begrenzte Ranking-Boosts und semantische Deduplizierung

• Erklärbare Suchergebnisse und eine private Relevanz-Benchmark

• Verwaltete Obsidian-Markdown-Projektion und portable verschlüsselte Exporte

• Responsive Dashboard für Desktop und mobiles Safari

• 24 eng begrenzte cloudmemory_*-MCP-Tools

• Optionale Konnektoren und Automatisierungs-Anmeldedaten, ohne eine Automatisierungsplattform zur Abhängigkeit zu machen

Architektur

Codex · Claude · OpenCode · compatible web clients
                         │
                 OAuth-protected MCP
                         │
             Cloudflare Worker + dashboard
                ┌────────┼────────┐
                │        │        │
               D1       KV    Static assets
           canonical   OAuth      UI
                │
       optional derived services
       Vectorize · Workers AI
                │
       optional encrypted export
             your GitHub repo

Der Worker, die Datenbank, der OAuth-Status und der optionale KI-Index gehören dem Anwender. Das öffentliche Projekt hat keinen zentralen Speicherdienst und keinen Zugriff auf bereitgestellte Instanzen. Siehe Architektur und Datenschutz.

Bereitstellung

1. Erstellen Sie Ihre Kopie

Verwenden Sie den Button „Deploy to Cloudflare“ oben. Cloudflare kann eine GitHub-Kopie erstellen und unterstützte Worker-Bindungen aus wrangler.jsonc bereitstellen.

Wenn die automatische Vectorize-Bereitstellung in Ihrem Konto nicht verfügbar ist, erstellen Sie den optionalen Index, bevor Sie die semantische Suche aktivieren:

npx wrangler vectorize create ai-cloud-memory --dimensions=768 --metric=cosine

Behalten Sie SEMANTIC_SEARCH_ENABLED=false bei, bis dieser Index existiert. Das Basisprodukt ruft in diesem Modus weder Workers AI noch Vectorize auf.

2. Wählen Sie die endgültige URL

Verwenden Sie den generierten workers.dev-Ursprung oder binden Sie Ihre endgültige benutzerdefinierte Domain an. Notieren Sie den genauen HTTPS-Ursprung ohne abschließenden Schrägstrich, zum Beispiel:

https://ai-cloud-memory.your-subdomain.workers.dev

Setzen Sie PUBLIC_ORIGIN auf diesen Ursprung. auto ist nur während der ersten Bereitstellung nützlich. Das Festlegen des endgültigen Ursprungs vor dem Erstellen von GitHub-OAuth vermeidet eine zweite OAuth-Callback-Migration.

3. Erstellen Sie eine GitHub-OAuth-App

Öffnen Sie in GitHub Einstellungen → Entwicklereinstellungen → OAuth-Apps → Neue OAuth-App.

Notieren Sie die Client-ID und generieren Sie ein Client-Secret. Committen Sie das Secret niemals.

4. Konfigurieren Sie die Eigentümer-Sperre

Setzen Sie diese nicht geheimen Worker-Variablen in wrangler.jsonc oder im Cloudflare-Dashboard:

ALLOWED_GITHUB_USER_ID=your numeric GitHub user ID
ALLOWED_GITHUB_LOGIN=your GitHub login
PUBLIC_ORIGIN=https://your-final-origin.example
SEMANTIC_SEARCH_ENABLED=false

Die numerische Benutzer-ID ist die unveränderliche Sicherheitsgrenze; der Login ist Anzeige-Metadaten. Setzen Sie die Geheimnisse von einem vertrauenswürdigen Terminal aus:

npx wrangler secret put GITHUB_CLIENT_ID
npx wrangler secret put GITHUB_CLIENT_SECRET
openssl rand -hex 32 | npx wrangler secret put COOKIE_ENCRYPTION_KEY

5. Migrieren und bereitstellen

npm ci
npm run check
npm run deploy

Der Bereitstellungsbefehl veröffentlicht auf einem frischen Konto absichtlich zweimal: Der erste Durchlauf lässt Cloudflare deklarierte Ressourcen automatisch bereitstellen, Migrationen initialisieren dann D1, und der letzte Durchlauf wird zur verifizierten Anwendungsversion. Die Platzhalter-Eigentümer-Sperre hält die Bootstrap-Bereitstellung unzugänglich, bis Sie sie ersetzen.

Öffnen Sie dann /setup.html auf Ihrem bereitgestellten Ursprung für die lokale, nur im Browser laufende Checkliste. Vollständige Anweisungen finden Sie in Bereitstellung und Onboarding.

AI-Client verbinden

Ihr Remote-MCP-Endpunkt ist:

https://your-final-origin.example/mcp

Häufige native Clients:

# Codex
codex mcp add cloud-memory --url https://your-final-origin.example/mcp

# Claude Code
claude mcp add --transport http cloud-memory https://your-final-origin.example/mcp

OpenCode kann einen Remote-MCP-Eintrag in opencode.json verwenden:

{
  "mcp": {
    "cloud-memory": {
      "type": "remote",
      "url": "https://your-final-origin.example/mcp",
      "enabled": true
    }
  }
}

Schließen Sie OAuth in jedem Client separat ab. Überprüfen Sie cloudmemory_health, cloudmemory_board, eine harmlose Suche und einen ausdrücklich genehmigten Schreibvorgang. Die Fähigkeiten von Web-Clients und Planeinschränkungen variieren. Siehe Client-Einrichtung.

Erforderliche und optionale Dienste

Cloudflares Limits und Preise können sich ändern. Überprüfen Sie die aktuellen Workers-Preise, D1-Preise, Vectorize-Preise und Workers-AI-Preise, bevor Sie optionale Dienste aktivieren. Dieses Projekt aktiviert keine kostenpflichtige Nutzung oder Abrechnung in Ihrem Namen.

Semantische Suche

Der sichere Standard ist nur lexikalisch:

SEMANTIC_SEARCH_ENABLED=false

Neue Erinnerungen bleiben in D1 kanonisch mit einem ausstehenden Vektorstatus. Wenn Sie die Variable auf true setzen, bereitstellen und dann in den Einstellungen Index reparieren wählen, füllt Cloud Memory Vektoren in begrenzten Stapeln nach. Das konfigurierte BGE-Modell verwendet einen 768-dimensionalen Kosinus-Index. Siehe Semantische Suche.

Backups und Wiederherstellung

Das Dashboard kann einen verschlüsselten Download ohne GitHub-Token erstellen. Optionale GitHub-Zustellung benötigt:

• EXPORT_ENCRYPTION_KEY, sicher außerhalb des Repositorys aufbewahrt

• GITHUB_EXPORT_TOKEN, ein fein abgestuftes Token mit Zugriff auf den Inhalt eines Backup-Repositorys

• GITHUB_EXPORT_REPOSITORY, in der Form owner/repository

Der Verlust des Verschlüsselungsschlüssels macht vorhandene verschlüsselte Exporte unwiederherstellbar. D1 bleibt kanonisch; Obsidian- und GitHub-Ausgaben sind Projektionen und Wiederherstellungsartefakte, keine gleichzeitigen Schreiber.

Lokale Entwicklung

Erfordert Node.js 22.12 oder neuer.

npm ci
npm run dev
npm run check

Der vollständige Check führt Repository-Sicherheitsvalidierung, Bereitstellungsvorlagen-Validierung, Lint, Typprüfung, Unit-Tests, Worker/D1-Tests und einen Produktions-Build aus.

Projekt-Governance

• Sicherheitsrichtlinie

• Mitwirken

• Support

• Verhaltenskodex

• Änderungsprotokoll

Die automatisierte Überprüfung durch Codex Cloud ist nicht Teil von AI Cloud Memory. Betreuer können dieses GitHub-Repository als externe Repository-Verwaltung mit einer Codex-Cloud-Umgebung verbinden; es wird kein Überprüfungsagent, Token oder Feature im Produkt ausgeliefert.

Lizenz

MIT. Cloudflare, GitHub, Claude, ChatGPT, Codex, OpenCode, Obsidian und n8n sind Marken ihrer jeweiligen Inhaber und stehen nicht in Verbindung mit diesem Projekt.