פתרונות
מפסיקים להסביר את הפרויקט מחדש
שמור החלטות, ניסיונות שנכשלו ועבודה פתוחה לסשן הבא עם הסוכן. מחשב שולחני ונייד יכולים לשתף את הזיכרון כששניהם מגיעים לאותו שרת. תכונות הזיכרון שבברירת המחדל אינן דורשות מפתח API של ספק מודלים.
צריכים את זה בכלל?
מחליפים סוכן באמצע משימה
נתקעתם ב-rate limit של Claude Code בארבע אחר הצהריים. פותחים את Codex באותה תיקייה וממשיכים.
Claude Code
ai-memory
העברת מקל
Codex
נתפס פעם אחת
סיכום
הצעדים הבאים
שאלות פתוחות
מטופסת
העברת מקל (handoff) כוללת סיכום של הסשן, את הצעדים הבאים ואת השאלות הפתוחות. הסוכן הבא מקבל אותה בתחילת הסשן, לפני שהקלדתם משהו.
גם כששום דבר לא נסגר
מגבלת מכסה או קריסה לא כותבות handoff. הסשן הבא מקבל את שם העבודה הלא גמורה ויכול לקרוא את התצפיות שלה.
נתפסת פעם אחת בלבד
הסשן הראשון שעומד בתנאים תופס את ההעברה. בקשה שנייה לא יכולה לתפוס אותה שוב. כך נמנעת מסירה כפולה של אותה העברה; שני סוכנים עדיין יכולים לבחור בנפרד עבודה דומה.
אוטומטית, עם אפשרות ידנית
כל סיום סשן כותב העברה. אומרים "שמור הקשר לסשן הבא" כדי לכתוב אחת משלכם, והיא גוברת על האוטומטית.
שני סוכנים, Grok Build CLI ו-Zero, מתעלמים ממה שה-hooks מדפיסים בתחילת הסשן. מבקשים מהם לקבל את ההעברה והם מושכים אותה דרך MCP. בדף האינטגרציות מופיעים כל הסוכנים ומה כל אחד מהם תומך.
מה אומרים ביום-יום
ברוב הימים לא אומרים כלום. ה-hooks לוכדים את הסשן, וסיום הסשן הופך אותו לדפי ויקי. כשכן רוצים משהו, הממשק הוא שפה רגילה.
- "איפה עצרנו?"
- קורא את ההעברה הממתינה: סיכום, צעדים הבאים, שאלות פתוחות.
- "דיברנו כבר על X?"
- מחפש בוויקי עם טקסט מלא, ישויות, קישורים ווקטורים בדירוג משולב אחד.
- "תעדכן אותי. לא הייתי פה."
- בונה תקציר שמתארך ככל שנעדרתם יותר זמן. עם LLM מוגדר זה טקסט רציף, ובלי LLM זה מידע מובנה.
- "תזכור את זה לתמיד."
- כותב דף קבוע עם גרסאות ב-git. מצמידים אותו והוא לא עובר דעיכה לעולם.
- "תזכור את זה עד יום שישי."
- כותב את הדף עם תאריך תפוגה. סבב השכחה (forget sweep) מוחק אותו אחרי התאריך.
- "הדף הזה לא מעודכן."
- מתעד משוב לשימור ול־lint. הוא אינו משנה את דירוג החיפוש ואינו מוחק את הדף ישירות.
במדריך השימוש ב-GitHub יש את רשימת המשפטים המלאה ואת כלי ה-MCP שמאחורי כל אחד.
launcher אחד, ודרך להכניס פרויקטים ישנים
מפעילים את הסוכן עם ai-memory run
- ההפעלה הראשונה מתקינה את ה-hooks ואת רשומת ה-MCP של אותו סוכן אם הם חסרים. זה קורה פעם אחת לכל סוכן.
- החלפת סוכן ממשיכה את אותו רצף עבודה, עם ההיסטוריה הגלויה בנוסף לסיכום שבהעברה.
ai-memory continueמוצא את ה-checkout האחרון שלכם מכל תיקייה וממשיך שם.- כרגע הוא מכסה 12 סוכנים. הפעלה ישירה של סוכן ממשיכה לעבוד, וה-hooks לבדם כבר מעבירים את המקל.
cd /path/to/project
ai-memory run claude
# יוצאים מ-Claude Code וממשיכים את אותו רצף עבודה ב-Codex.
ai-memory run codex --yolo
# מכל תיקייה: להחזיר אותי למקום שבו הייתי.
ai-memory continue
מאמצים פרויקט שכבר קיים
הסשן הראשון בפרויקט ריק מייבא פעם אחת את היסטוריית הסוכנים המקומית שלכם, עד 25 הסשנים האחרונים. אפשר גם להריץ את זה ידנית.
# בודקים מה ייובא, ואז מייבאים
ai-memory backfill --dry-run
ai-memory backfill
אפשר לבטל את הייבוא האוטומטי בהרצה הראשונה עם AI_MEMORY_BACKFILL_ON_START=false.
# דורש ספק LLM בשרת
ai-memory bootstrap --dry-run
ai-memory bootstrap
Bootstrap קורא את ה-git log, את ה-README, את docs/ ואת קובצי הכללים שלכם. הפרויקט מדד הרצה שעלתה הרבה פחות מ-0.20 דולר עם Kimi 2.6 דרך OpenRouter. הוא עלול לכתוב דפים שנשמעים נכון והם שגויים, אז כדאי לקרוא קודם את הרצת הניסיון (dry run).
אותו זיכרון במחשב הנייח ובנייד
מפעילים שרת אחד ומחברים אליו את המחשבים. כברירת מחדל, זיהוי הפרויקט מבוסס על ה-git remote; תיקיות בלי remote תקין מזוהות לפי שם התיקייה. קובצי סימון יכולים לשנות זאת, לכן כשמחברים מחשב נוסף כדאי לבדוק איזה פרויקט זוהה.
PC
שרת ai-memory אחד
נייד
אופליין
תור מקומי
שרת ai-memory אחד
מתרוקן אחר כך
- שמים את השרת על מכונת homelab, או על המחשב שנשאר דלוק. זה קובץ בינארי אחד או קונטיינר אחד.
- כשהנייד אופליין, אירועי ה-hooks נכנסים ל-spool מקומי ומתרוקנים כשהשרת שוב זמין. לכל רשומה יש מפתח idempotency, כך ששום דבר לא נשמר פעמיים.
ai-memory statusמראה כמה אירועים ממתינים ובן כמה הוותיק שבהם.- גישה מרחוק דורשת טוקן bearer ו־TLS, גם ברשת המקומית שלך. הגדר את שניהם לפני חיבור מחשב נוסף.
# במחשב הנייח ובנייד
export AI_MEMORY_SERVER_URL="https://memory.example.com"
export AI_MEMORY_AUTH_TOKEN='REPLACE_WITH_YOUR_SERVER_TOKEN'
ai-memory install-mcp --client claude-code --apply
ai-memory install-hooks --agent claude-code --apply
# ואז מפעילים כרגיל
ai-memory run claude
זיכרון מקומי וקבצים קריאים
הרצת התקנת ברירת המחדל לא עולה כלום, והיא שומרת הכול כ-markdown בתוך git repository.
אפס קריאות ל-LLM
לכידה, סיכומי סשנים, העברות וחיפוש רצים כולם בלי מודל. הסיכומים מבוססי כללים עד שמוסיפים ספק.
ה-embeddings רצים בתוך הקובץ הבינארי
מודל מקומי קטן (all-MiniLM-L6-v2, כ-87 MB) יורד פעם אחת ברקע. החיפוש הווקטורי נדלק בהפעלה מחדש הבאה. לא צריך מפתח ולא צריך GPU.
רק loopback
שרת ברירת המחדל מאזין ב-127.0.0.1:49374, בלי חשבון ובלי טלמטריה. שום דבר אחר ברשת לא יכול להגיע אליו.
קובצי markdown פשוטים
grep
Obsidian
עריכה
rsync
היסטוריית git
לוקחים את הקבצים לכל מקום
אפשר לקרוא ולערוך את דפי ה־Markdown. Reindex בונה מחדש את אינדקס החיפוש שלהם, אך סשנים, העברות וחשבונות זקוקים גם למסד. השתמש ב־ai-memory backup; git push של הוויקי לבדו אינו גיבוי מלא.
# מעתיקים את הוויקי מהקונטיינר ופותחים אותו ב-Obsidian
docker cp ai-memory:/data/wiki ./my-ai-memory-wiki
# או קוראים את ההיסטוריה שלו
git -C /data/wiki log --oneline
דפדפן לזיכרון שלך
אפשרות אחת פותחת בדפדפן לוח בקרה עם פרויקטים, פעילות, דפים שמורים, חיפוש ותיבות דואר. דפי הוויקי נשארים לקריאה בלבד; משתמשים מורשים יכולים לשלוח או לערוך הודעות ממתינות.
ai-memory serve --transport http --bind 127.0.0.1:49374 --enable-web
# ואז פותחים את http://127.0.0.1:49374/web
שאלות ותשובות
צריך מפתח API או LLM כדי להשתמש ב-ai-memory?
לא. לכידה, סיכומי סשנים, העברות וחיפוש עובדים עם אפס קריאות ל-LLM. ה-embeddings לחיפוש הווקטורי רצים בתוך התהליך עם מודל מקומי. ספק LLM הוא אופציונלי ומוסיף איחוד עשיר יותר, bootstrap ו-reranking.
חייבים להשתמש ב-ai-memory מהיום הראשון של הפרויקט?
לא. אפשר להוסיף אותו בכל שלב. הסשן הראשון בפרויקט שעדיין אין לו זיכרון מייבא את סשני הסוכנים שכבר נמצאים על המחשב, מכל הסוכנים הנתמכים, עד 25 הסשנים האחרונים. הייבוא רץ פעם אחת, ברקע, בלי LLM. בנוסף, ai-memory bootstrap יכול לבנות דפים מתוך ה-git log, ה-README והתיעוד שלכם, והוא כן דורש LLM.
אפשר להשתמש באותו זיכרון במחשב נייח ובנייד?
כן. מריצים שרת ai-memory אחד על מכונת homelab או על אחד המחשבים, ומפנים אליו את שניהם. אין רפליקציה בין שרתים. אם הנייד אופליין, אירועי ה-hooks נשמרים ב-spool מקומי ומתרוקנים כשהשרת שוב זמין.
הזיכרון המובנה של Claude Code מספיק?
למפתח אחד על מחשב אחד שמשתמש רק ב-Claude Code, ייתכן שכן. הוא מפסיק להספיק כשמוסיפים סוכן שני, מחשב שני או אדם שני.
איפה הזיכרון שלי נשמר?
Reindex בונה מחדש דפים, קישורים וחיפוש טקסט מתוך Markdown. הוא אינו משחזר סשנים, תצפיות, העברות, משתמשים, מפתחות או ביקורת שקיימים רק במסד.
תנו לסוכנים שלכם זיכרון, כבר היום.
חינמי ובקוד פתוח. תכונות הזיכרון שבברירת המחדל אינן דורשות מפתח ספק מודלים, והנתונים בבעלותך.