AI Cloud Memory Community Edition

Tu propia memoria compartida, tablero de proyecto y hoja de ruta a largo plazo para clientes de IA, ejecutándose en tu cuenta de Cloudflare y propiedad de tu identidad de GitHub.

AI Cloud Memory ofrece a Codex, Claude Code, OpenCode y clientes web compatibles un único endpoint MCP autenticado para memoria duradera y trabajo de ciclo de vida de proyectos. D1 es canónico. La búsqueda funciona en modo léxico y temporal por defecto, mientras que Vectorize y Workers AI pueden habilitarse más adelante para recuperación semántica y reordenamiento.

No se requiere n8n, servidor doméstico, cuenta de proveedor ni servicio operado por este proyecto. Cada adoptante despliega una copia aislada en sus propias cuentas de Cloudflare y GitHub.

Lo que obtienes

• OAuth de GitHub solo para propietario y OAuth MCP con alcance

• Memorias y directivas permanentes con procedencia, etiquetas, archivo, sustitución y revisión

• Proyectos, tareas Kanban, recibos de finalización, trabajo archivado e historial de Done

• Hojas de ruta de proyectos a largo plazo con promoción segura a tareas

• Manejo de consultas temporales, aumentos de clasificación limitados y deduplicación semántica

• Resultados de búsqueda explicables y un punto de referencia de relevancia privado

• Proyección gestionada de Obsidian Markdown y exportaciones cifradas portátiles

• Panel receptivo diseñado para Safari de escritorio y móvil

• 24 herramientas MCP cloudmemory_* de alcance limitado

• Conectores opcionales y credenciales de automatización, sin convertir una plataforma de automatización en una dependencia

Arquitectura

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

El Worker, la base de datos, el estado de OAuth y el índice de IA opcional pertenecen al adoptante. El proyecto público no tiene ningún servicio de memoria central ni acceso a las instancias desplegadas. Consulte Arquitectura y Privacidad.

Despliegue

1. Crea tu copia

Usa el botón Deploy to Cloudflare de arriba. Cloudflare puede crear una copia de GitHub y aprovisionar los bindings de Worker compatibles desde wrangler.jsonc.

Si el aprovisionamiento automático de Vectorize no está disponible en tu cuenta, crea el índice opcional antes de habilitar la búsqueda semántica:

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

Mantén SEMANTIC_SEARCH_ENABLED=false hasta que ese índice exista. El producto base no llama a Workers AI ni a Vectorize en este modo.

2. Elige la URL final

Usa el origen workers.dev generado o adjunta tu dominio personalizado final. Registra el origen HTTPS exacto sin barra final, por ejemplo:

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

Establece PUBLIC_ORIGIN a ese origen. auto solo es útil durante el despliegue inicial. Establecer el origen final antes de crear GitHub OAuth evita una segunda migración de devolución de llamada de OAuth.

3. Crea una aplicación GitHub OAuth

En GitHub, abre Configuración → Configuración de desarrollador → Aplicaciones OAuth → Nueva aplicación OAuth.

Registra el ID de cliente y genera un secreto de cliente. Nunca comprometas el secreto.

4. Configura el bloqueo de propietario

Establece estas variables de Worker no secretas en wrangler.jsonc o en el panel de Cloudflare:

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

El ID de usuario numérico es el límite de seguridad inmutable; el inicio de sesión es metadatos de visualización. Establece los secretos desde una terminal de confianza:

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. Migra y despliega

npm ci
npm run check
npm run deploy

El comando de despliegue publica intencionalmente dos veces en una cuenta nueva: la primera pasada permite que Cloudflare aprovisione automáticamente los recursos declarados, las migraciones luego inicializan D1, y la pasada final se convierte en la versión de aplicación verificada. El bloqueo de propietario de marcador de posición mantiene el despliegue de arranque inaccesible hasta que lo reemplaces.

Luego abre /setup.html en tu origen desplegado para la lista de verificación local, solo para navegador. Las instrucciones completas están en Despliegue y Incorporación.

Conecta un cliente de IA

Tu endpoint MCP remoto es:

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

Clientes nativos comunes:

# 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 puede usar una entrada MCP remota en opencode.json:

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

Completa OAuth por separado en cada cliente. Verifica cloudmemory_health, cloudmemory_board, una búsqueda inofensiva y una escritura explícitamente aprobada. Las capacidades del cliente web y las restricciones del plan varían. Consulta Configuración del cliente.

Servicios requeridos y opcionales

Los límites y precios de Cloudflare pueden cambiar. Consulta los precios actuales de Workers, D1, Vectorize y Workers AI antes de habilitar servicios opcionales. Este proyecto no habilita uso de pago ni facturación en tu nombre.

Búsqueda semántica

El valor predeterminado seguro es solo léxico:

SEMANTIC_SEARCH_ENABLED=false

Las nuevas memorias permanecen canónicas en D1 con un estado de vector pendiente. Cuando establezcas la variable en true, despliega y luego elige Repair index en Configuración, Cloud Memory rellena los vectores en lotes limitados. El modelo BGE configurado utiliza un índice coseno de 768 dimensiones. Consulta Búsqueda semántica.

Copias de seguridad y recuperación

El panel puede crear una descarga cifrada sin un token de GitHub. La entrega opcional de GitHub necesita:

• EXPORT_ENCRYPTION_KEY, conservada en un lugar seguro fuera del repositorio

• GITHUB_EXPORT_TOKEN, un token de grano fino con alcance de acceso a Contents en un repositorio de copia de seguridad

• GITHUB_EXPORT_REPOSITORY, en formato owner/repository

Perder la clave de cifrado hace que las exportaciones cifradas existentes sean irrecuperables. D1 sigue siendo canónico; las salidas de Obsidian y GitHub son proyecciones y artefactos de recuperación, no escritores concurrentes.

Desarrollo local

Requiere Node.js 22.12 o superior.

npm ci
npm run dev
npm run check

La verificación completa ejecuta validación de seguridad del repositorio, validación de plantillas de despliegue, lint, verificación de tipos, pruebas unitarias, pruebas de Worker/D1 y una compilación de producción.

Gobernanza del proyecto

• Política de seguridad

• Contribución

• Soporte

• Código de conducta

• Registro de cambios

La revisión automatizada de Codex Cloud no forma parte de AI Cloud Memory. Los mantenedores pueden conectar este repositorio de GitHub a un entorno de Codex Cloud como administración externa del repositorio; no se incluye ningún agente de revisión, token o característica en el producto.

Licencia

MIT. Cloudflare, GitHub, Claude, ChatGPT, Codex, OpenCode, Obsidian y n8n son marcas comerciales de sus respectivos propietarios y no están afiliados a este proyecto.