🌐 Esta es una traducción automática. ¡Las correcciones de la comunidad son bienvenidas!

<h1 align="center">
  <br>
  <a href="https://github.com/thedotmack/claude-mem">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-dark-mode.webp">
      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-light-mode.webp">
      <img src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-light-mode.webp" alt="Claude-Mem" width="400">
    </picture>
  </a>
  <br>
  <a href="https://vercel.com/open-source-program">
    <img alt="Vercel OSS Program" src="https://vercel.com/oss/program-badge-2026.svg" />
  </a>
</h1>

<p align="center">
  <a href="docs/i18n/README.zh.md">🇨🇳 中文</a> •
  <a href="docs/i18n/README.zh-tw.md">🇹🇼 繁體中文</a> •
  <a href="docs/i18n/README.ja.md">🇯🇵 日本語</a> •
  <a href="docs/i18n/README.pt.md">🇵🇹 Português</a> •
  <a href="docs/i18n/README.pt-br.md">🇧🇷 Português</a> •
  <a href="docs/i18n/README.ko.md">🇰🇷 한국어</a> •
  <a href="docs/i18n/README.es.md">🇪🇸 Español</a> •
  <a href="docs/i18n/README.de.md">🇩🇪 Deutsch</a> •
  <a href="docs/i18n/README.fr.md">🇫🇷 Français</a> •
  <a href="docs/i18n/README.he.md">🇮🇱 עברית</a> •
  <a href="docs/i18n/README.ar.md">🇸🇦 العربية</a> •
  <a href="docs/i18n/README.ru.md">🇷🇺 Русский</a> •
  <a href="docs/i18n/README.pl.md">🇵🇱 Polski</a> •
  <a href="docs/i18n/README.cs.md">🇨🇿 Čeština</a> •
  <a href="docs/i18n/README.nl.md">🇳🇱 Nederlands</a> •
  <a href="docs/i18n/README.tr.md">🇹🇷 Türkçe</a> •
  <a href="docs/i18n/README.uk.md">🇺🇦 Українська</a> •
  <a href="docs/i18n/README.vi.md">🇻🇳 Tiếng Việt</a> •
  <a href="docs/i18n/README.tl.md">🇵🇭 Tagalog</a> •
  <a href="docs/i18n/README.id.md">🇮🇩 Indonesia</a> •
  <a href="docs/i18n/README.th.md">🇹🇭 ไทย</a> •
  <a href="docs/i18n/README.hi.md">🇮🇳 हिन्दी</a> •
  <a href="docs/i18n/README.bn.md">🇧🇩 বাংলা</a> •
  <a href="docs/i18n/README.ur.md">🇵🇰 اردو</a> •
  <a href="docs/i18n/README.ro.md">🇷🇴 Română</a> •
  <a href="docs/i18n/README.sv.md">🇸🇪 Svenska</a> •
  <a href="docs/i18n/README.it.md">🇮🇹 Italiano</a> •
  <a href="docs/i18n/README.el.md">🇬🇷 Ελληνικά</a> •
  <a href="docs/i18n/README.hu.md">🇭🇺 Magyar</a> •
  <a href="docs/i18n/README.fi.md">🇫🇮 Suomi</a> •
  <a href="docs/i18n/README.da.md">🇩🇰 Dansk</a> •
  <a href="docs/i18n/README.no.md">🇳🇴 Norsk</a>
</p>

<h4 align="center">Sistema de compresión de memoria persistente construido para <a href="https://claude.com/claude-code" target="_blank">Claude Code</a>.</h4>

<p align="center">
  <a href="LICENSE">
    <img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License">
  </a>
  <a href="package.json">
    <img src="https://img.shields.io/badge/version-13.4.0-green.svg" alt="Version">
  </a>
  <a href="package.json">
    <img src="https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg" alt="Node">
  </a>
  <a href="https://github.com/thedotmack/awesome-claude-code">
    <img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome Claude Code">
  </a>
</p>

<p align="center">
  <a href="https://trendshift.io/repositories/15496" target="_blank">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge-dark.svg">
      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge.svg">
      <img src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge.svg" alt="thedotmack/claude-mem | Trendshift" width="250" height="55"/>
    </picture>
  </a>
</p>

<br>

<table align="center">
  <tr>
    <td align="center">
      <a href="https://github.com/thedotmack/claude-mem">
        <picture>
          <img
            src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/cm-preview.gif"
            alt="Claude-Mem Preview"
            width="500"
          >
        </picture>
      </a>
    </td>
    <td align="center">
      <a href="https://www.star-history.com/#thedotmack/claude-mem&Date">
        <picture>
          <source
            media="(prefers-color-scheme: dark)"
            srcset="https://api.star-history.com/image?repos=thedotmack/claude-mem&type=date&theme=dark&legend=top-left"
          />
          <source
            media="(prefers-color-scheme: light)"
            srcset="https://api.star-history.com/image?repos=thedotmack/claude-mem&type=date&legend=top-left"
          />
          <img
            alt="Star History Chart"
            src="https://api.star-history.com/image?repos=thedotmack/claude-mem&type=date&legend=top-left"
            width="500"
          />
        </picture>
      </a>
    </td>
  </tr>
</table>

<p align="center">
  <a href="#inicio-rápido">Inicio Rápido</a> •
  <a href="#cómo-funciona">Cómo Funciona</a> •
  <a href="#herramientas-de-búsqueda-mcp">Herramientas de Búsqueda</a> •
  <a href="#documentación">Documentación</a> •
  <a href="#configuración">Configuración</a> •
  <a href="#solución-de-problemas">Solución de Problemas</a> •
  <a href="#licencia">Licencia</a>
</p>

<p align="center">
  Claude-Mem preserva el contexto sin interrupciones entre sesiones al capturar automáticamente observaciones de uso de herramientas, generar resúmenes semánticos y ponerlos a disposición de sesiones futuras. Esto permite a Claude mantener la continuidad del conocimiento sobre proyectos incluso después de que las sesiones terminen o se reconecten.
</p>

---

## Inicio Rápido

Instala con un solo comando:

```bash
npx claude-mem install
```

O instala para OpenCode:

```bash
npx claude-mem install --ide opencode
```

O instala para Antigravity CLI ([guía de configuración](https://docs.claude-mem.ai/antigravity-cli/setup)):

```bash
npx claude-mem install --ide antigravity
```

O instala desde el marketplace de plugins dentro de Claude Code:

```bash
/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem
```

Reinicia Claude Code. El contexto de sesiones anteriores aparecerá automáticamente en nuevas sesiones.

> **Nota:** Claude-Mem también está publicado en npm, pero `npm install -g claude-mem` instala **únicamente el SDK/librería** — no registra los hooks del plugin ni configura el servicio worker. Instala siempre mediante `npx claude-mem install` o los comandos `/plugin` mencionados arriba.

### 🦞 OpenClaw Gateway

Instala claude-mem como plugin de memoria persistente en gateways de [OpenClaw](https://openclaw.ai) con un solo comando:

```bash
curl -fsSL https://install.cmem.ai/openclaw.sh | bash
```

El instalador se encarga de las dependencias, la configuración del plugin, la configuración del proveedor de IA, el inicio del worker y, opcionalmente, de los feeds de observación en tiempo real hacia Telegram, Discord, Slack y más. Consulta la [Guía de Integración con OpenClaw](https://docs.claude-mem.ai/openclaw-integration) para más detalles.

**Características Principales:**

- 🧠 **Memoria Persistente** - El contexto sobrevive entre sesiones
- 📊 **Divulgación Progresiva** - Recuperación de memoria en capas con visibilidad del costo de tokens
- 🔍 **Búsqueda Basada en Habilidades** - Consulta el historial de tu proyecto con la habilidad mem-search
- 🖥️ **Interfaz de Visor Web** - Transmisión de memoria en tiempo real en la URL del worker impresa al iniciar
- 💻 **Habilidad para Claude Desktop** - Busca en la memoria desde conversaciones de Claude Desktop
- 🔒 **Control de Privacidad** - Usa etiquetas `<private>` para excluir contenido sensible del almacenamiento
- ⚙️ **Configuración de Contexto** - Control detallado sobre qué contexto se inyecta
- 🤖 **Operación Automática** - No se requiere intervención manual
- 🔗 **Citas** - Referencia observaciones pasadas con IDs a través de la API del worker o visualiza todas en el visor web

---

## Documentación

📚 **[Ver Documentación Completa](https://docs.claude-mem.ai/)** - Navegar en el sitio web oficial

### Primeros Pasos

- **[Guía de Instalación](https://docs.claude-mem.ai/installation)** - Inicio rápido e instalación avanzada
- **[Guía de Uso](https://docs.claude-mem.ai/usage/getting-started)** - Cómo funciona Claude-Mem automáticamente
- **[Herramientas de Búsqueda](https://docs.claude-mem.ai/usage/search-tools)** - Consulta el historial de tu proyecto con lenguaje natural

### Mejores Prácticas

- **[Ingeniería de Contexto](https://docs.claude-mem.ai/context-engineering)** - Principios de optimización de contexto para agentes de IA
- **[Divulgación Progresiva](https://docs.claude-mem.ai/progressive-disclosure)** - Filosofía detrás de la estrategia de preparación de contexto de Claude-Mem

### Arquitectura

- **[Descripción General](https://docs.claude-mem.ai/architecture/overview)** - Componentes del sistema y flujo de datos
- **[Evolución de la Arquitectura](https://docs.claude-mem.ai/architecture-evolution)** - El viaje de v3 a v5
- **[Arquitectura de Hooks](https://docs.claude-mem.ai/hooks-architecture)** - Cómo Claude-Mem usa hooks de ciclo de vida
- **[Referencia de Hooks](https://docs.claude-mem.ai/architecture/hooks)** - 7 scripts de hooks explicados
- **[Servicio Worker](https://docs.claude-mem.ai/architecture/worker-service)** - API HTTP y gestión de Bun
- **[Base de Datos](https://docs.claude-mem.ai/architecture/database)** - Esquema SQLite y búsqueda FTS5
- **[Arquitectura de Búsqueda](https://docs.claude-mem.ai/architecture/search-architecture)** - Búsqueda híbrida con base de datos vectorial Chroma

### Configuración y Desarrollo

- **[Configuración](https://docs.claude-mem.ai/configuration)** - Variables de entorno y ajustes
- **[Desarrollo](https://docs.claude-mem.ai/development)** - Compilación, pruebas y contribución
- **[Ramas de Publicación](https://docs.claude-mem.ai/branches)** - Flujo de las ramas stable, core-dev y community-edge
- **[Solución de Problemas](https://docs.claude-mem.ai/troubleshooting)** - Problemas comunes y soluciones

---

## Cómo Funciona

**Componentes Principales:**

1. **5 Hooks de Ciclo de Vida** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 scripts de hooks)
2. **Instalación Inteligente** - Verificador de dependencias en caché (script pre-hook, no un hook de ciclo de vida)
3. **Servicio Worker** - API HTTP local con interfaz de visor web y endpoints de búsqueda, gestionado por Bun
4. **Base de Datos SQLite** - Almacena sesiones, observaciones, resúmenes
5. **Habilidad mem-search** - Consultas en lenguaje natural con divulgación progresiva
6. **Base de Datos Vectorial Chroma** - Búsqueda híbrida semántica + palabras clave para recuperación inteligente de contexto

Ver [Descripción General de la Arquitectura](https://docs.claude-mem.ai/architecture/overview) para más detalles.

---

## Herramientas de Búsqueda MCP

Claude-Mem proporciona búsqueda inteligente de memoria a través de **4 herramientas MCP** siguiendo un patrón de flujo de trabajo de **3 capas** eficiente en tokens:

**El Flujo de Trabajo de 3 Capas:**

1. **`search`** - Obtén un índice compacto con IDs (~50-100 tokens/resultado)
2. **`timeline`** - Obtén contexto cronológico alrededor de resultados interesantes
3. **`get_observations`** - Obtén detalles completos SOLO para los IDs filtrados (~500-1,000 tokens/resultado)

**Cómo Funciona:**
- Claude usa herramientas MCP para buscar en tu memoria
- Comienza con `search` para obtener un índice de resultados
- Usa `timeline` para ver qué estaba ocurriendo alrededor de observaciones específicas
- Usa `get_observations` para obtener detalles completos de los IDs relevantes
- **Ahorro de tokens de ~10x** al filtrar antes de obtener los detalles

**Herramientas MCP Disponibles:**

1. **`search`** - Busca en el índice de memoria con consultas de texto completo, filtra por tipo/fecha/proyecto
2. **`timeline`** - Obtén contexto cronológico alrededor de una observación o consulta específica
3. **`get_observations`** - Obtén detalles completos de observaciones por IDs (siempre agrupa varios IDs)

**Ejemplo de Uso:**

```typescript
// Paso 1: Buscar el índice
search(query="authentication bug", type="bugfix", limit=10)

// Paso 2: Revisar el índice, identificar IDs relevantes (ej. #123, #456)

// Paso 3: Obtener detalles completos
get_observations(ids=[123, 456])
```

Ver [Guía de Herramientas de Búsqueda](https://docs.claude-mem.ai/usage/search-tools) para ejemplos detallados.

---

## Ramas de Publicación

Las versiones estables se publican desde `main` y se distribuyen en npm. `core-dev` y
`community-edge` son ramas que se ejecutan desde el código fuente para correcciones tempranas
de fiabilidad e integraciones de la comunidad. Consulta **[Ramas de Publicación](https://docs.claude-mem.ai/branches)**
para conocer el flujo de ramas y las instrucciones de ejecución no estable.

---

## Requisitos del Sistema

- **Node.js**: 20.0.0 o superior
- **Claude Code**: Última versión con soporte de plugins
- **Bun**: Runtime de JavaScript y gestor de procesos (se instala automáticamente si falta)
- **uv**: Gestor de paquetes de Python para búsqueda vectorial (se instala automáticamente si falta)
- **SQLite 3**: Para almacenamiento persistente (incluido)

---
### Notas de Configuración para Windows

Si ves un error como:

```powershell
npm : The term 'npm' is not recognized as the name of a cmdlet
```

Asegúrate de que Node.js y npm estén instalados y agregados a tu PATH. Descarga el instalador más reciente de Node.js desde https://nodejs.org y reinicia tu terminal después de la instalación.

---

## Configuración

Los ajustes se gestionan en `~/.claude-mem/settings.json` (se crea automáticamente con valores predeterminados en la primera ejecución). Configura el modelo de IA, puerto del worker, directorio de datos, nivel de registro y ajustes de inyección de contexto.

Ver la **[Guía de Configuración](https://docs.claude-mem.ai/configuration)** para todos los ajustes disponibles y ejemplos.

### Configuración de Modo e Idioma

Claude-Mem admite múltiples modos de flujo de trabajo e idiomas a través del ajuste `CLAUDE_MEM_MODE`.

Esta opción controla tanto:
- El comportamiento del flujo de trabajo (ej. code, chill, investigation)
- El idioma usado en las observaciones generadas

#### Cómo Configurarlo

Edita tu archivo de ajustes en `~/.claude-mem/settings.json`:

```json
{
  "CLAUDE_MEM_MODE": "code--zh"
}
```

Los modos están definidos en `plugin/modes/`. Para ver todos los modos disponibles localmente:

```bash
ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/
```

#### Modos Disponibles

| Modo | Descripción |
|------------|-------------------------|
| `code` | Modo predeterminado en inglés |
| `code--zh` | Modo en chino simplificado |
| `code--ja` | Modo en japonés |

Los modos específicos de idioma siguen el patrón `code--[lang]` donde `[lang]` es el código de idioma ISO 639-1 (ej., `zh` para chino, `ja` para japonés, `es` para español).

> Nota: `code--zh` (chino simplificado) ya viene incorporado — no se requiere instalación adicional ni actualización del plugin.

#### Después de Cambiar el Modo

Reinicia Claude Code para aplicar la nueva configuración de modo.
---

## Desarrollo

Ver la **[Guía de Desarrollo](https://docs.claude-mem.ai/development)** para instrucciones de compilación, pruebas y flujo de contribución.

---

## Solución de Problemas

Si experimentas problemas, describe el problema a Claude y la habilidad troubleshoot diagnosticará automáticamente y proporcionará soluciones.

Ver la **[Guía de Solución de Problemas](https://docs.claude-mem.ai/troubleshooting)** para problemas comunes y soluciones.

---

## Reportes de Errores

Crea reportes de errores completos con el generador automático:

```bash
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report
```

## Contribuciones

¡Las contribuciones son bienvenidas! Por favor:

1. Haz fork del repositorio
2. Crea una rama de característica
3. Realiza tus cambios con pruebas
4. Actualiza la documentación
5. Envía un Pull Request

Claude-Mem se distribuye desde tres ramas: `main` (estable), `core-dev` y
`community-edge`. Solo `main` se publica en npm; las demás se ejecutan desde
el código fuente. Consulta [Ramas de Publicación](https://docs.claude-mem.ai/branches) para conocer la
estrategia y las instrucciones de ejecución local.

Ver [Guía de Desarrollo](https://docs.claude-mem.ai/development) para el flujo de contribución.

---

## Licencia

Claude-Mem está licenciado bajo la Apache License 2.0.

Elegimos Apache-2.0 porque la memoria agéntica duradera debe ser fácil de integrar en
herramientas para desarrolladores, agentes locales, servidores MCP, sistemas empresariales, pilas de robótica
y entornos de agentes en producción.

Consulta el archivo [LICENSE](LICENSE) para todos los detalles. Consulta [docs/license.md](docs/license.md)
y [docs/ip-boundary.md](docs/ip-boundary.md) para el alcance de la licencia y el límite
entre lo abierto y lo comercial.

**Nota sobre Ragtime**: El directorio `ragtime/` está licenciado bajo la **Apache License 2.0**. Consulta [ragtime/LICENSE](ragtime/LICENSE) para más detalles.

---

## Soporte

- **Documentación**: [docs/](docs/)
- **Problemas**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues)
- **Repositorio**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem)
- **Cuenta Oficial de X**: [@Claude_Memory](https://x.com/Claude_Memory)
- **Discord Oficial**: [Únete a Discord](https://discord.com/invite/J4wttp9vDu)
- **Autor**: Alex Newman ([@thedotmack](https://github.com/thedotmack))

---

**Construido con Claude Agent SDK** | **Funciona con Claude Code** | **Hecho con TypeScript**

---

### ¿Qué Hay de CMEM?

CMEM es un token creado por un tercero, pero adoptado oficialmente por el creador de Claude-Mem (Alex Newman, @thedotmack). El token actúa como catalizador comunitario para el crecimiento y como vehículo para llevar CMEM a los desarrolladores y trabajadores del conocimiento que más lo necesitan.

CA Oficial en BASE: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3