🌐 Tämä on automaattinen käännös. Yhteisön korjaukset ovat tervetulleita!

<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">Pysyvä muistinpakkaamisjärjestelmä, joka on rakennettu <a href="https://claude.com/claude-code" target="_blank">Claude Code</a> -ympäristöön varten.</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="#pikaopas">Pikaopas</a> •
  <a href="#miten-se-toimii">Miten se toimii</a> •
  <a href="#mcp-hakutyökalut">Hakutyökalut</a> •
  <a href="#dokumentaatio">Dokumentaatio</a> •
  <a href="#asetukset">Asetukset</a> •
  <a href="#vianmääritys">Vianmääritys</a> •
  <a href="#lisenssi">Lisenssi</a>
</p>

<p align="center">
  Claude-Mem säilyttää kontekstin saumattomasti istuntojen välillä tallentamalla automaattisesti työkalujen käyttöhavaintoja, luomalla semanttisia yhteenvetoja ja asettamalla ne tulevien istuntojen saataville. Tämä mahdollistaa sen, että Claude säilyttää tiedon jatkuvuuden projekteista senkin jälkeen, kun istunnot päättyvät tai yhteys muodostetaan uudelleen.
</p>

---

## Pikaopas

Asenna yhdellä komennolla:

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

Tai asenna OpenCodelle:

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

Tai asenna Antigravity CLI:lle ([asennusopas](https://docs.claude-mem.ai/antigravity-cli/setup)):

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

Tai asenna plugin-markkinapaikalta Claude Coden sisältä:

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

/plugin install claude-mem
```

Käynnistä Claude Code uudelleen. Aiempien istuntojen konteksti ilmestyy automaattisesti uusiin istuntoihin.

> **Huomio:** Claude-Mem on julkaistu myös npm:ssä, mutta `npm install -g claude-mem` asentaa **vain SDK:n/kirjaston** — se ei rekisteröi plugin-koukkuja eikä määritä worker-palvelua. Asenna aina komennolla `npx claude-mem install` tai yllä olevilla `/plugin`-komennoilla.

### 🦞 OpenClaw Gateway

Asenna claude-mem pysyväksi muistipluginiksi [OpenClaw](https://openclaw.ai)-yhdyskäytäviin yhdellä komennolla:

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

Asennusohjelma hoitaa riippuvuudet, plugin-asetukset, AI-palveluntarjoajan määrityksen, workerin käynnistyksen ja valinnaiset reaaliaikaiset havaintosyötteet Telegramiin, Discordiin, Slackiin ja muihin. Katso lisätietoja [OpenClaw-integraatio-oppaasta](https://docs.claude-mem.ai/openclaw-integration).

**Keskeiset ominaisuudet:**

- 🧠 **Pysyvä muisti** - Konteksti säilyy istuntojen välillä
- 📊 **Asteittainen paljastaminen** - Kerrostettu muistin haku tokenikustannusten näkyvyydellä
- 🔍 **Taitopohjainen haku** - Kysy projektihistoriaasi mem-search-taidolla
- 🖥️ **Web-katselukäyttöliittymä** - Reaaliaikainen muistivirta käynnistyksen yhteydessä tulostetussa worker-osoitteessa
- 💻 **Claude Desktop -taito** - Hae muistista Claude Desktop -keskusteluissa
- 🔒 **Yksityisyyden hallinta** - Käytä `<private>`-tageja arkaluonteisen sisällön poissulkemiseen tallennuksesta
- ⚙️ **Kontekstin määrittely** - Tarkka hallinta siitä, mikä konteksti injektoidaan
- 🤖 **Automaattinen toiminta** - Ei vaadi manuaalista puuttumista
- 🔗 **Viittaukset** - Viittaa aiempiin havaintoihin ID:llä worker-API:n kautta tai näytä kaikki web-katselussa

---

## Dokumentaatio

📚 **[Näytä täydellinen dokumentaatio](https://docs.claude-mem.ai/)** - Selaa virallisella verkkosivustolla

### Aloitus

- **[Asennusopas](https://docs.claude-mem.ai/installation)** - Pikaopas ja edistynyt asennus
- **[Käyttöopas](https://docs.claude-mem.ai/usage/getting-started)** - Miten Claude-Mem toimii automaattisesti
- **[Hakutyökalut](https://docs.claude-mem.ai/usage/search-tools)** - Kysy projektihistoriaasi luonnollisella kielellä

### Parhaat käytännöt

- **[Kontekstisuunnittelu](https://docs.claude-mem.ai/context-engineering)** - AI-agentin kontekstin optimointiperiaatteet
- **[Asteittainen paljastaminen](https://docs.claude-mem.ai/progressive-disclosure)** - Filosofia Claude-Mem-kontekstin valmistelustrategian takana

### Arkkitehtuuri

- **[Yleiskatsaus](https://docs.claude-mem.ai/architecture/overview)** - Järjestelmän komponentit ja datavirta
- **[Arkkitehtuurin kehitys](https://docs.claude-mem.ai/architecture-evolution)** - Matka versiosta v3 versioon v5
- **[Koukku-arkkitehtuuri](https://docs.claude-mem.ai/hooks-architecture)** - Miten Claude-Mem käyttää elinkaarikoukkuja
- **[Koukkuviittaus](https://docs.claude-mem.ai/architecture/hooks)** - 7 koukku-skriptiä selitettynä
- **[Worker-palvelu](https://docs.claude-mem.ai/architecture/worker-service)** - HTTP API ja Bun-hallinta
- **[Tietokanta](https://docs.claude-mem.ai/architecture/database)** - SQLite-skeema ja FTS5-haku
- **[Hakuarkkitehtuuri](https://docs.claude-mem.ai/architecture/search-architecture)** - Hybridihaku Chroma-vektoritietokannalla

### Asetukset ja kehitys

- **[Asetukset](https://docs.claude-mem.ai/configuration)** - Ympäristömuuttujat ja asetukset
- **[Kehitys](https://docs.claude-mem.ai/development)** - Rakentaminen, testaus, osallistuminen
- **[Julkaisuhaarat](https://docs.claude-mem.ai/branches)** - Stable-, core-dev- ja community-edge-haarojen kulku
- **[Vianmääritys](https://docs.claude-mem.ai/troubleshooting)** - Yleiset ongelmat ja ratkaisut

---

## Miten se toimii

**Keskeiset komponentit:**

1. **5 elinkaarikoukua** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 koukku-skriptiä)
2. **Älykäs asennus** - Välimuistettu riippuvuuksien tarkistaja (esikoukku-skripti, ei elinkaarikoukku)
3. **Worker-palvelu** - Paikallinen HTTP API web-katselukäyttöliittymällä ja hakupäätepisteillä, Bun-hallinnoimana
4. **SQLite-tietokanta** - Tallentaa istunnot, havainnot, yhteenvedot
5. **mem-search-taito** - Luonnollisen kielen kyselyt asteittaisella paljastamisella
6. **Chroma-vektoritietokanta** - Hybridi semanttinen + avainsanahaku älykkääseen kontekstin hakuun

Katso [Arkkitehtuurin yleiskatsaus](https://docs.claude-mem.ai/architecture/overview) yksityiskohdista.

---

## MCP-hakutyökalut

Claude-Mem tarjoaa älykkään muistihaun **4 MCP-työkalun** kautta noudattaen tokentehokasta **3-kerroksista työnkulkumallia**:

**3-kerroksinen työnkulku:**

1. **`search`** - Hae tiivis hakemisto ID:illä (~50-100 tokenia/tulos)
2. **`timeline`** - Hae kronologinen konteksti kiinnostavien tulosten ympäriltä
3. **`get_observations`** - Hae täydet tiedot VAIN suodatetuille ID:ille (~500-1 000 tokenia/tulos)

**Miten se toimii:**
- Claude käyttää MCP-työkaluja muistisi hakemiseen
- Aloita `search`-työkalulla saadaksesi hakemiston tuloksista
- Käytä `timeline`-työkalua nähdäksesi, mitä tapahtui tiettyjen havaintojen ympärillä
- Käytä `get_observations`-työkalua hakeaksesi täydet tiedot relevanteille ID:ille
- **~10-kertainen tokenisäästö** suodattamalla ennen tietojen hakemista

**Saatavilla olevat MCP-työkalut:**

1. **`search`** - Hae muistihakemistosta koko tekstin kyselyillä, suodata tyypin/päivämäärän/projektin mukaan
2. **`timeline`** - Hae kronologinen konteksti tietyn havainnon tai kyselyn ympäriltä
3. **`get_observations`** - Hae täydet havaintotiedot ID:iden perusteella (yhdistä aina useita ID:itä)

**Esimerkkikäyttö:**

```typescript
// Vaihe 1: Hae hakemisto
search(query="authentication bug", type="bugfix", limit=10)

// Vaihe 2: Tarkista hakemisto, tunnista relevantit ID:t (esim. #123, #456)

// Vaihe 3: Hae täydet tiedot
get_observations(ids=[123, 456])
```

Katso [Hakutyökalujen opas](https://docs.claude-mem.ai/usage/search-tools) yksityiskohtaisia esimerkkejä varten.

---

## Julkaisuhaarat

Vakaat julkaisut toimitetaan `main`-haarasta ja julkaistaan npm:ssä. `core-dev`- ja
`community-edge`-haarat ovat lähdekoodista ajettavia haaroja varhaisia luotettavuuskorjauksia ja
yhteisöintegraatioita varten. Katso **[Julkaisuhaarat](https://docs.claude-mem.ai/branches)**
haarojen kulusta ja ei-vakaiden versioiden ajo-ohjeista.

---

## Järjestelmävaatimukset

- **Node.js**: 20.0.0 tai uudempi
- **Claude Code**: Uusin versio plugin-tuella
- **Bun**: JavaScript-ajoympäristö ja prosessinhallinta (asennetaan automaattisesti jos puuttuu)
- **uv**: Python-paketinhallinta vektorihakuun (asennetaan automaattisesti jos puuttuu)
- **SQLite 3**: Pysyvälle tallennukselle (sisältyy)

---
### Windows-asennusohjeita

Jos näet virheen kuten:

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

Varmista, että Node.js ja npm on asennettu ja lisätty PATH-muuttujaan. Lataa uusin Node.js-asennusohjelma osoitteesta https://nodejs.org ja käynnistä pääte uudelleen asennuksen jälkeen.

---

## Asetukset

Asetuksia hallitaan tiedostossa `~/.claude-mem/settings.json` (luodaan automaattisesti oletusarvoilla ensimmäisellä suorituskerralla). Määritä AI-malli, worker-portti, datahakemisto, lokitaso ja kontekstin injektointiasetukset.

Katso **[Asetusopas](https://docs.claude-mem.ai/configuration)** kaikista saatavilla olevista asetuksista ja esimerkeistä.

### Tilan ja kielen määritys

Claude-Mem tukee useita työnkulkutiloja ja kieliä `CLAUDE_MEM_MODE`-asetuksen kautta.

Tämä asetus hallitsee sekä:
- Työnkulun käyttäytymistä (esim. code, chill, investigation)
- Luotujen havaintojen kieltä

#### Miten määrittää

Muokkaa asetustiedostoasi osoitteessa `~/.claude-mem/settings.json`:

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

Tilat on määritelty kansiossa `plugin/modes/`. Nähdäksesi kaikki saatavilla olevat tilat paikallisesti:

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

#### Saatavilla olevat tilat

| Tila | Kuvaus |
|------------|-------------------------|
| `code` | Oletusarvoinen englanninkielinen tila |
| `code--zh` | Yksinkertaistettu kiina -tila |
| `code--ja` | Japani-tila |

Kielikohtaiset tilat noudattavat mallia `code--[lang]`, jossa `[lang]` on ISO 639-1 -kielikoodi (esim. `zh` kiinalle, `ja` japanille, `es` espanjalle).

> Huomio: `code--zh` (yksinkertaistettu kiina) on jo sisäänrakennettu — lisäasennusta tai plugin-päivitystä ei tarvita.

#### Tilan vaihtamisen jälkeen

Käynnistä Claude Code uudelleen soveltaaksesi uuden tila-asetuksen.
---

## Kehitys

Katso **[Kehitysopas](https://docs.claude-mem.ai/development)** rakennusohjeista, testauksesta ja osallistumisen työnkulusta.

---

## Vianmääritys

Jos kohtaat ongelmia, kuvaile ongelma Claudelle ja troubleshoot-taito diagnosoi automaattisesti ja tarjoaa korjauksia.

Katso **[Vianmääritysopas](https://docs.claude-mem.ai/troubleshooting)** yleisistä ongelmista ja ratkaisuista.

---

## Bugiraportit

Luo kattavia bugiraportteja automaattisella generaattorilla:

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

## Osallistuminen

Osallistuminen on tervetullutta! Ole hyvä ja:

1. Haarukoi repositorio
2. Luo ominaisuushaara
3. Tee muutoksesi testeineen
4. Päivitä dokumentaatio
5. Lähetä Pull Request

Claude-Mem toimitetaan kolmesta haarasta: `main` (vakaa), `core-dev` ja
`community-edge`. Vain `main` julkaistaan npm:ssä; muut ajetaan
lähdekoodista. Katso [Julkaisuhaarat](https://docs.claude-mem.ai/branches) strategiasta ja
paikallisista ajo-ohjeista.

Katso [Kehitysopas](https://docs.claude-mem.ai/development) osallistumisen työnkulusta.

---

## Lisenssi

Claude-Mem on lisensoitu Apache License 2.0 -lisenssillä.

Valitsimme Apache-2.0:n, koska pysyvän agenttimuistin tulisi olla helppo upottaa
kehittäjätyökaluihin, paikallisiin agentteihin, MCP-palvelimiin, yritysjärjestelmiin, robotiikkapinoihin
ja tuotannon agenttiratkaisuihin.

Katso [LICENSE](LICENSE)-tiedosto täysistä yksityiskohdista. Katso [docs/license.md](docs/license.md)
ja [docs/ip-boundary.md](docs/ip-boundary.md) lisenssoinnin laajuudesta ja
avoimen/kaupallisen rajan osalta.

**Huomio Ragtimesta**: `ragtime/`-hakemisto on lisensoitu **Apache License 2.0** -lisenssillä. Katso [ragtime/LICENSE](ragtime/LICENSE) lisätietoja varten.

---

## Tuki

- **Dokumentaatio**: [docs/](docs/)
- **Ongelmat**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues)
- **Repositorio**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem)
- **Virallinen X-tili**: [@Claude_Memory](https://x.com/Claude_Memory)
- **Virallinen Discord**: [Liity Discordiin](https://discord.com/invite/J4wttp9vDu)
- **Tekijä**: Alex Newman ([@thedotmack](https://github.com/thedotmack))

---

**Rakennettu Claude Agent SDK:lla** | **Toimii Claude Coden kanssa** | **Tehty TypeScriptillä**

---

### Entä CMEM?

CMEM on kolmannen osapuolen luoma token, jonka Claude-Memin luoja (Alex Newman, @thedotmack) on virallisesti hyväksynyt. Token toimii yhteisön kasvun katalysaattorina ja välineenä, jolla CMEM tuodaan niiden kehittäjien ja tietotyöläisten saataville, jotka sitä eniten tarvitsevat.

Virallinen BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3