Grok Buildin istuntojen välinen muisti: asetukset ja rajoitukset

xAI:n terminaaliagentissa Grok Buildissa on istuntojen välinen muisti: se voi muistaa projektin käytäntöjä, päätöksiä ja toimiviksi osoittautuneita virheenjäljitysvaiheita ja lisätä ne sitten uuden istunnon kontekstiin ilman muistutuksia. Ominaisuus on oletusarvoisesti pois päältä ja kokeellinen – sen voi ottaa käyttöön yhdellä asetuksella.

Tämä kuvaus perustuu xai-org/grok-build-repossa olevaan viralliseen oppaaseen 20. syyskuuta 2026. Alkuperäisen artikkelin kirjoittaja ei kokeillut tuotetta: toimintaa kuvataan dokumentaation perusteella, ei henkilökohtaisten testien pohjalta.

Käytännön tietoa Ailootin käytöstä on dokumentaatiossa.

Mitä hyötyä muistista on Grok Buildissa?#

Olet esimerkiksi selittänyt agentille yhdessä istunnossa, että projektissa käytetään kahden välilyönnin sisennystä, tietokannan migraatiot suoritetaan erillisellä komennolla ja tietty moduuli käsittelee maksuja. Uudessa istunnossa sinun on annettava nämä tiedot uudelleen.

Kun muisti on käytössä, Grok Build voi:

• palauttaa mieleen aiemmin selittämäsi projektikäytännöt;
• hyödyntää jo toimiviksi osoittautuneita virheenjäljitysvaiheita;
• siirtää arkkitehtuuripäätökset myöhempiin istuntoihin;
• välttää kysymästä uudelleen asioita, joihin on jo vastattu.

Ominaisuus on kokeellinen ja oletusarvoisesti pois päältä. Agentin toiminta ei muutu ennen kuin otat sen käyttöön.

Miten otat muistin käyttöön?#

Kerran, yhtä suoritusta varten:

GROK_MEMORY=1 grok

Muuttuja koskee vain tätä suoritusta. Komento export GROK_MEMORY=1 säilyttää asetuksen nykyisessä komentotulkissa ja ottaa muistin käyttöön kaikissa sitä seuraavissa grok-suorituksissa kyseisessä komentotulkissa, kunnes pääteistunto päättyy tai suoritat komennon export GROK_MEMORY=0.

Pysyvästi asetustiedoston kautta. Lisää tämä tiedostoon ~/.grok/config.toml:

[memory]
enabled = true

Istunnon aikana ilman uudelleenkäynnistystä: avaa /memory ja paina t.

Tämä valitsin vaikuttaa vain nykyiseen istuntoon eikä sitä kirjoiteta asetustiedostoon. Sen avulla voi ottaa muistin käyttöön tai poistaa sen käytöstä. Käytöstä poistaminen estää pääsyn muistityökaluihin mutta ei poista tiedostoja levyltä; kun otat muistin uudelleen käyttöön, tallennustila tulee taas käyttöön. Valitsin ei voi ohittaa prosessitason pakotettua muistin käytöstä poistamista asetuksella GROK_MEMORY=0: /memory ei ole käytettävissä koko istunnon aikana.

Jos asetuksia määritetään useassa paikassa, niiden prioriteetti on seuraava:

• GROK_MEMORY=0 poistaa muistin käytöstä koko prosessilta, ja sen prioriteetti on korkein.
• Asetustiedoston nimenomainen enabled = false poistaa muistin käytöstä, vaikka hallittu etäasetus ottaisi sen käyttöön.
• Muistin voi ottaa käyttöön asetuksella GROK_MEMORY=1, asetustiedoston arvolla enabled = true tai hallitulla etäasetuksella.
• Jos asetusta ei määritetä, muisti on pois päältä.

Muistiinpanot lisätään istunnon ensimmäisellä vuorolla. Jos otit muistin käyttöön kesken työskentelyn ja haluat agentin alkavan käyttää tallennettuja projektitietoja, suorita /new. Voit tarkistaa, onko muisti käytössä, komennon grok inspect tulosteesta.

Mitä Grok Build tallentaa ja minne?#

Hakemiston ~/.grok/memory/ rakenne:

Projektihakemiston nimeen lisätään lyhyt hash repon tunnisteesta. Tunnistukseen käytetään origin-etäosoitetta muodossa ”organisaatio/repo” tai hakemistopolkua, jos Git-repoa ei ole. Siksi saman repon kloonit ja worktreet (Git-haarojen erilliset työkopiot) jakavat saman projektimuistin: agentin yhdessä kopiossa muistamat asiat ovat käytettävissä myös toisessa.

Merkintöjä syntyy neljällä tavalla:

1. Automaattinen yhteenveto istunnon päättyessä. Kun istunto päättyy, Grok Build tallentaa päivittäiseen lokiin lyhyen järjestelmäyhteenvedon: viestien määrän, enintään viisi ensimmäistä sisällöllistä keskusteluvaihtoa sekä päivämäärän ja kellonajan. Yhteenveto muodostetaan metatiedoista ilman mallikutsua tai viivettä. Hyvin lyhyet istunnot ohitetaan: merkintää ei luoda, jos sisällöllisiä keskusteluvaihtoja on alle kolme tai kirjoittamaasi tekstiä on alle 50 tavua. Yhteenveto ei sisällä käytettyjä työkaluja, tiedostopolkuja eikä komentoja. Automaattiset yhteenvedot voi poistaa käytöstä asetuksella session.save_on_end = false.
2. /flush – yksityiskohtainen muistiinpano pyynnöstä. Tällä komennolla malli tiivistää nykyisen istunnon tärkeimmät asiat: päätökset, toimintamallit, virheenjäljitysvaiheet ja API-havainnot. Yhteenveto kirjoitetaan päivättyyn lokiin ja indeksoidaan tulevia istuntoja varten. Dokumentaatiossa suositellaan suorittamaan /flush ennen kontekstin tiivistämistä, onnistuneen virheenjäljitysistunnon lopuksi ja tärkeiden toimintamallien havaitsemisen jälkeen.
3. /remember – nimenomainen pyyntö muistaa jokin asia. Kirjoita /remember always open PR links after sending tai sano agentille ”muista, että...”. Ennen merkinnän kirjoittamista avautuu tarkistusnäkymä: muistiinpano tallennetaan vasta vahvistuksesi jälkeen, ja syötteeseen ilmestyy Memory saved to ~/.grok/memory/MEMORY.md. Projektin tiedot tallennetaan projektin MEMORY.md-tiedostoon, ja kaikkiin projekteihin liittyvät tiedot yleiseen tiedostoon.
4. /dream – koonti. Komento ryhmittelee hajanaiset lokit ja muistiinpanot aiheittain ja poistaa kaksoiskappaleet haun tarkkuuden parantamiseksi. Kuten /flush-komennon tapauksessa, koonnin tekee malli: se lukee kertyneet merkinnät ja kirjoittaa ne uudelleen aiheittain, joten tulos kannattaa tarkistaa säännöllisesti komennolla /memory. Käytettävissä on myös automaattinen tila: oletusarvoisesti Grok Build tarkistaa ehdot käynnistyksen yhteydessä ja kerran tunnissa ja aloittaa koonnin, kun vähintään 24 tuntia on kulunut ja istuntoja on kertynyt vähintään 5. Kynnysarvoja voi säätää asetustiedoston osiossa [memory.dream].

Muistiinpanoja haetaan SQLite-indeksin avulla: oletusarvoisesti käytössä on FTS5-kokotekstihaku, ja jos upotusmalli on määritetty, siihen lisätään semanttinen vektorihaku.

Miten muisti siirtyy uuteen istuntoon?#

Alustavan lisäyksen valintakynnys on min_score = 0.9, jota voit muuttaa osiossa [memory.initial_injection]. Automaattisen kontekstin tiivistämisen jälkeen agentti hakee muistista uudelleen palauttaakseen tiedot, jotka ovat saattaneet poistua kontekstista vanhempien keskusteluvaihtojen mukana.

Voit myös kysyä agentilta suoraan: ”Mitä muistat?” Se ryhmittelee vastauksen lähteen mukaan: yleiset mieltymykset, projektitiedot ja istuntohistoria.

Istuntomerkinnöissä on ajantasaisuusmerkintöjä. Mitä vanhempi istuntolokin merkintä on, sitä painokkaammin se merkitään: ”Tarkista, että tämä on yhä ajankohtaista, ennen kuin luotat siihen.” Yleisiin ja projektikohtaisiin MEMORY.md-tiedostoihin tällaisia merkintöjä ei lisätä: niiden sisältö on tarkoitettu pitkäaikaiseen käyttöön, joten sinun on itse huolehdittava sen paikkansapitävyydestä.

Miten muistiinpanoja tarkastellaan, muokataan ja poistetaan?#

Istunnossa suoritettu /memory-komento avaa ikkunan, jossa kaikki muistitiedostot on ryhmitelty laajuuden mukaan: yleiset, projekti ja istunnot (käänteisessä aikajärjestyksessä). Tiedostoluettelo on vasemmalla ja valitun tiedoston vain luku -esikatselu oikealla.

Yleisnäkymän hyödylliset näppäimet:

Ikkunassa voi poistaa yksittäisiä muistiinpanoja ja istuntotiedostoja, mutta sillä ei voi poistaa luotuja MEMORY.md-indeksitiedostoja (yleistä ja projektikohtaista).

Toinen tapa on muokata tiedostoja suoraan. Ne sijaitsevat hakemistossa ~/.grok/memory/, ja ne voi avata millä tahansa editorilla. Hakemiston muutoksia seurataan: luodut ja muokatut tiedostot indeksoidaan uudelleen, ja poistetut tiedostot poistetaan indeksistä seuraavan haun yhteydessä.

Pyyntö ”unohda snake_case” toimii ilman takuuta: malli etsii vastaavat merkinnät ja poistaa niitä, mutta voi jättää joitakin huomaamatta. Jos haluat varmistaa poistamisen, avaa tiedosto (voit kopioida sen polun kätevästi komennolla y näkymässä /memory) ja poista merkintä itse. Voit tyhjentää muistin kokonaan komentoriviltä: grok memory clear poistaa projektimuistin, grok memory clear --global yleisen muistin ja grok memory clear --all molemmat.

Miten muisti eroaa repon ohjetiedostosta?#

Repon ohje jaetaan kaikille projektissa työskenteleville, ja se näkyy koodissa ja muutoshistoriassa. Muisti karttuu istuntojen aikana, tallennetaan koneellesi eikä julkaistu itsestään.

Muisti ei korvaa ohjetiedostoa. Yleiset projektisäännöt, joita koko tiimi ja kaikki agentit tarvitsevat, kuuluvat edelleen repoon. Meillä on erillinen opas yhden ohjetiedoston käyttämiseen Claude Codessa, Codexissa ja Cursorissa: AGENTS.md ja CLAUDE.md yhdessä. Muisti säilyttää henkilökohtaisen kontekstisi: mieltymyksesi, jo kokeillut asiat ja tehdyn päätöksen.

Claude noudattaa samanlaista erottelua: kerromme artikkelissa Claude-muisti ja CLAUDE.md, miten muisti eroaa CLAUDE.md-tiedostosta. Työkalujen vertailu on oppaassa Grok Build vai Claude Code.

Rajoitukset ja muistin toiminnan tarkistaminen#

Pidä seuraavat rajoitukset mielessä:

• Kokeellinen tila. Komennot, kynnysarvot ja toiminta voivat muuttua tulevissa versioissa. Tarkista repon muistiohje, jos jokin ei toimi odotetusti.
• Alustava lisäys uudessa istunnossa. Aloita työ komennolla /new muistin käyttöönoton jälkeen, jotta tallennetut muistiinpanot lisätään ensimmäisellä vuorolla.
• Malli päättää, mikä on tärkeää. Malli luo /flush-yhteenvedon ja valitsee, mitä muistiinpanoon sisällytetään. Avaa /memory viikon tai kahden välein ja tarkista, mitä on kertynyt; poista tarpeettomat tiedot.
• Älä pyydä agenttia muistamaan salaisuuksia. Avaimet, tokenit ja salasanat eivät kuulu pitkäaikaisiin muistiinpanoihin: hakemiston ~/.grok/memory/ tiedostot tallennetaan raakatekstinä. Jos muistiin tallentuu arkaluonteisia tietoja, poista ne muokkaamalla tiedostoa.
• Projektimuisti jaetaan repon kopioiden kesken. Jos agentti muistaa yhdessä kloonissa jotain, joka on toisessa vanhentunutta, ota jaettu hakemisto huomioon siivotessasi.

Jos muisti ei toimi:

1. Tarkista komennon grok inspect tulosteesta, että muisti on käytössä.
2. Tarkista, etteivät GROK_MEMORY=0 tai asetustiedosto poista sitä käytöstä.
3. Suorita vianmääritystä varten RUST_LOG=debug GROK_LOG_FILE=/tmp/grok.log grok ja tarkista muistia koskevat rivit tiedostosta /tmp/grok.log.

Lyhyt yhteenveto#

Grok Buildin muistin voi ottaa käyttöön asetuksella GROK_MEMORY=1 tai lisäämällä ~/.grok/config.toml-tiedostoon [memory] enabled = true. Aloita uusi istunto komennolla /new, jotta muistiinpanot lisätään ensimmäisen kerran käyttöönoton jälkeen. Agentti tallentaa muistiinpanot hakemistoon ~/.grok/memory/: istuntoyhteenvedot ilman mallikutsua, yksityiskohtaiset yhteenvedot komennolla /flush, nimenomaiset merkinnät komennolla /remember vahvistuksesi jälkeen ja aiheittain järjestetyt muistiinpanot komennolla /dream. Tarkastele ja siivoa muistiinpanoja komennolla /memory tai muokkaamalla tiedostoja suoraan. Ominaisuus on kokeellinen, joten tarkista kynnysarvot ja komennot virallisesta oppaasta ja käy muistiinpanot läpi säännöllisesti.

Järjestelmällisessä työskentelyssä yhdistelmä AI-klooni + Second Brain + Context Engineering on hyödyllinen.

Avaa Ailoot.