פתרונות
מפסיקים להסביר את הפרויקט מחדש
סוגרים סוכן אחד, פותחים אחר, והוא כבר מכיר את הארכיטקטורה, את הגישות שנכשלו ואת מה שעוד פתוח. זה עובד אותו דבר מהמחשב הנייח ומהנייד, ולא צריך מפתח API.
מחליפים סוכן באמצע משימה
נתקעתם ב-rate limit של Claude Code בארבע אחר הצהריים. פותחים את Codex באותה תיקייה וממשיכים.
מטופסת
העברת מקל (handoff) כוללת סיכום של הסשן, את הצעדים הבאים ואת השאלות הפתוחות. הסוכן הבא מקבל אותה בתחילת הסשן, לפני שהקלדתם משהו.
נתפסת פעם אחת בלבד
הסשן הראשון שעולה בתיקייה הזאת תופס את המקל. סשן שני שמבקש אותו לא מקבל כלום, כך ששני סוכנים אף פעם לא ממשיכים את אותה עבודה.
אוטומטית, עם אפשרות ידנית
כל סיום סשן כותב העברה. אומרים "שמור הקשר לסשן הבא" כדי לכתוב אחת משלכם, והיא גוברת על האוטומטית.
שני סוכנים, Grok Build CLI ו-Zero, מתעלמים ממה שה-hooks מדפיסים בתחילת הסשן. מבקשים מהם לקבל את ההעברה והם מושכים אותה דרך MCP. בדף האינטגרציות מופיעים כל הסוכנים ומה כל אחד מהם תומך.
מה אומרים ביום-יום
ברוב הימים לא אומרים כלום. ה-hooks לוכדים את הסשן, וסיום הסשן הופך אותו לדפי ויקי. כשכן רוצים משהו, הממשק הוא שפה רגילה.
- "איפה עצרנו?"
- קורא את ההעברה הממתינה: סיכום, צעדים הבאים, שאלות פתוחות.
- "דיברנו כבר על X?"
- מחפש בוויקי עם טקסט מלא, ישויות, קישורים ווקטורים בדירוג משולב אחד.
- "תעדכן אותי. לא הייתי פה."
- בונה תקציר שמתארך ככל שנעדרתם יותר זמן. עם LLM מוגדר זה טקסט רציף, ובלי LLM זה מידע מובנה.
- "תזכור את זה לתמיד."
- כותב דף קבוע עם גרסאות ב-git. מצמידים אותו והוא לא עובר דעיכה לעולם.
- "תזכור את זה עד יום שישי."
- כותב את הדף עם תאריך תפוגה. סבב השכחה (forget sweep) מוחק אותו אחרי התאריך.
- "הדף הזה לא מעודכן."
- רושם משוב שמוריד את הדף בדירוגים הבאים. משוב אף פעם לא מוחק שום דבר.
במדריך השימוש ב-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).
אותו זיכרון במחשב הנייח ובנייד
מריצים שרת קטן אחד ומפנים אליו כל מחשב. פרויקט מזוהה לפי שם ה-checkout שלו, כך שנתיבים שונים בכל מחשב מגיעים לאותו זיכרון.
- שמים את השרת על מכונת homelab, או על המחשב שנשאר דלוק. זה קובץ בינארי אחד או קונטיינר אחד.
- כשהנייד אופליין, אירועי ה-hooks נכנסים ל-spool מקומי ומתרוקנים כשהשרת שוב זמין. לכל רשומה יש מפתח idempotency, כך ששום דבר לא נשמר פעמיים.
ai-memory statusמראה כמה אירועים ממתינים ובן כמה הוותיק שבהם.- שרת שמאזין מעבר ל-loopback מחייב bearer token. הטוקן לא מצפין את התעבורה, אז מוסיפים TLS לפני שיוצאים מה-LAN.
# במחשב הנייח ובנייד
export AI_MEMORY_SERVER_URL="http://<server-ip>:49374"
export AI_MEMORY_AUTH_TOKEN="$TOKEN"
ai-memory install-mcp --client claude-code --apply
ai-memory install-hooks --agent claude-code --apply
בלי מפתח API, ועם קבצים שאפשר לקרוא
הרצת התקנת ברירת המחדל לא עולה כלום, והיא שומרת הכול כ-markdown בתוך git repository.
אפס קריאות ל-LLM
לכידה, סיכומי סשנים, העברות וחיפוש רצים כולם בלי מודל. הסיכומים מבוססי כללים עד שמוסיפים ספק.
ה-embeddings רצים בתוך הקובץ הבינארי
מודל מקומי קטן (all-MiniLM-L6-v2, כ-87 MB) יורד פעם אחת ברקע. החיפוש הווקטורי נדלק בהפעלה מחדש הבאה. לא צריך מפתח ולא צריך GPU.
רק loopback
שרת ברירת המחדל מאזין ב-127.0.0.1:49374, בלי חשבון ובלי טלמטריה. שום דבר אחר ברשת לא יכול להגיע אליו.
לוקחים את הקבצים לכל מקום
אינדקס ה-SQLite נגזר מהקבצים ואפשר לבנות אותו מהם מחדש. מגבים עם ai-memory backup, עם rsync, או עם git push ל-remote משלכם.
# מעתיקים את הוויקי מהקונטיינר ופותחים אותו ב-Obsidian
docker cp ai-memory:/data/wiki ./my-ai-memory-wiki
# או קוראים את ההיסטוריה שלו
git -C /data/wiki log --oneline
או גולשים בו בממשק web לקריאה בלבד
דגל אחד מוסיף תצוגת דפדפן עם רשימת הפרויקטים, עץ הדפים, markdown מרונדר, חיפוש וקישורי ויקי לחיצים. אי אפשר לערוך דרכה שום דבר.
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, ייתכן שכן. הוא מפסיק להספיק כשמוסיפים סוכן שני, מחשב שני או אדם שני.
איפה הזיכרון שלי נשמר?
בתיקייה של קובצי markdown פשוטים עם גרסאות ב-git, בתוך תיקיית הנתונים של ai-memory. ב-SQLite יושב אינדקס חיפוש שאפשר לבנות מחדש מהקבצים.
תנו לסוכנים שלכם זיכרון, כבר היום.
חינם ובקוד פתוח. בלי חשבון ובלי מפתח API, והקבצים נשארים שלכם.