זיכרון לכלים שלך
ערכת ה־SDK האופציונלית ל־TypeScript משתמשת בקריאות MCP עם תחום מוגדר לשמירה, חיפוש והעברת זיכרון. כתיבות מותנות מזהות עריכות מקבילות. בנה אותה מהמאגר; היא אינה מפורסמת ב־npm.
המוצר
עוד דברים שאפשר לעשות
העברות וחיפוש הם השימוש היום-יומי. אלה שאר הדברים שזיכרון שחי בשרת אחד יכול לעשות בשבילכם, מהעברת עבודה בין פרויקטים ועד הפרדה בין הזיכרון של לקוח אחד לזה של לקוח אחר.
סוכן אחד מבקש משהו מהסוכן של פרויקט אחר
שני repositories שמדברים דרך API, לכל אחד סוכן משלו וזיכרון משלו. הסוכן של ה-frontend מכיר את הפרוטוקול. במקום לקרוא את כל ה-repository של ה-API, הוא כותב בקשה מלאה ומניח אותה ב-inbox של הפרויקט ההוא.
פרויקט A
שליחה
ה-inbox, נתפס פעם אחת
פרויקט B
משיכה
מפרט API
קלט לא מהימן
אין הקשר משותף
איך זה נראה
ב-repository של ה-frontend
> תבקש מהסוכן ב-default/api להוסיף endpoint /v1/export שמזרים NDJSON, לשמור על ה-auth middleware הקיים, ותשלח את זה דרך ai-memory.
הסוכן קורא ל-memory_message_send עם גוף הודעה שעומד בפני עצמו. הבקשה חייבת להסתדר לבד, כי מי שקורא אותה לא רואה את הפרויקט הזה.
מאוחר יותר, ב-repository של ה-API
📬 ai-memory: הודעה 1 מפרויקט אחר ממתינה ב-inbox של הפרויקט הזה.
> תבדוק את ה-inbox שלי ב-ai-memory.
הסוכן קורא ל-memory_message_pop, מקבל את הבקשה יחד עם מי ששלח אותה, ועובד לפיה. משיכה שנייה לא מחזירה כלום.
# שולחים מהפרויקט הנוכחי
ai-memory message send --to-workspace default --to-project api \
--subject "export endpoint" "Add a /v1/export endpoint that streams NDJSON…"
# בפרויקט השני: מציגים בלי לצרוך, או תופסים את הוותיקה ביותר
ai-memory message list
ai-memory message pop
# מתחרטים לפני שההודעה נתפסה
ai-memory message cancel --id <message-id>
לפרויקט או לסוכן
הודעה מיועדת לסביבת עבודה ולפרויקט, ואפשר לכוון אותה לסוכן רשום מסוים. רק הסוכן הזה יכול לאסוף הודעה ממוקדת. בדפדפן ניתן לשלוח ולערוך הודעות ממתינות עם גישה לשני הפרויקטים.
שום דבר לא נכנס להקשר מעצמו
ההודעה בתחילת הסשן נושאת רק ספירה. טקסט ההודעה מגיע לסוכן רק במשיכה מכוונת, מגודר ומסומן כלא מהימן, כשהשולח מוצג מחוץ לגדר. פרויקט יכול לבחור לקבל את אותה הודעה, עם המספר בלבד, גם בפרומפטים.
נכשל במצב סגור
פרויקט היעד חייב להיות קיים, ולכן שגיאת הקלדה נדחית במקום לנחות ב-inbox שאף אחד לא קורא. כל inbox מחזיק לכל היותר 256 הודעות ממתינות.
ניתן לביטול, נרשם ביומן
השולח יכול לבטל הודעה עד שהיא נתפסת. סודות מוסרים בשליחה, גודל הגוף מוגבל, ובשרת משותף כל הודעה רושמת מי שלח אותה.
מפרידים בין לקוחות, mono-repos ועבודה אישית
הזיכרון מתויק לפי workspace ופרויקט. checkout עם git remote מתויק לפי ה-remote הזה, כך שאותו repository שעבר clone פעמיים חולק זיכרון אחד, ותיקייה בלי remote משתמשת בשם שלה. קובץ קטן משנה את השאר.
client-a
client-b
personal
ה-workspaces
.ai-memory.toml
ה-mono-repo
כללים
פג ביום שישי
משוב
workspace אחד לכל לקוח
מניחים
.ai-memory.tomlב-~/work/client-a/, וה-repositories שמתחתיו משתמשים באותו workspace. כך נקבע היכן הזיכרון נשמר ומחופש כברירת מחדל. זה אינו כלל בקרת גישה: חיפושים יזומים בין פרויקטים ופרופילים משותפים דורשים התייחסות נפרדת.Mono-repo כפרויקט אחד
קובץ סימון שמגדיר project מצמיד אליו את כל תתי-התיקיות, כך שהחבילות חולקות זיכרון אחד. בלי project, כל חבילה שומרת על זיכרון משלה.
Git worktrees
worktrees מקושרים מתמפים ל-repository הראשי, כך ש-branch שעשו לו checkout במקום אחר שומר על אותו זיכרון.
שני סוכנים בפרויקט אחד
ניתוב לפי זהות מפריד בין קוראים. סשנים מקבילים של אותו אדם עדיין דורשים ארגומנטים מפורשים של workspace/project או לקוח שמעביר את מזהה סשן ההוק; הגדרות MCP סטטיות לא תמיד מבדילות ביניהם.
מחשב אחד, שני מעסיקים
רושמים כל שרת עם
ai-memory server addונותנים לו שם בקובץ הסימון עםserver = "team-b". ה-hooks מהעץ הזה הולכים לשם ולשום מקום אחר, ושם שלא נפתר לא שולח כלום.identity מוצמד
identity = "acme/platform"מתייק checkout תחת המפתח הזה בכל מקום שהוא נמצא, גם בלי remote.
# כל repository מתחת לתיקייה הזאת מתויק תחת ה-workspace client-a
workspace = "client-a"
כללים שמגיעים לכל סשן
אומרים לסוכן לזכור משהו לתמיד, וזה הופך לדף בוויקי. כללים מתויקים בנפרד מעובדות, ותדריך הסשן יכול להציב אותם מול הסוכן עוד לפני הפרומפט הראשון.
אומרים פעם אחת
"תזכור: לפני שנוגעים בקוד התשלומים, קוראים את הערות ה-PCI." הסוכן כותב דף קבוע. מבקשים שזה יהיה כלל גלובלי, והוא חל על כל הפרויקטים שלכם.
התדריך מכניס אותם
עם
inject_on_session_start = trueבקובץ הסמן של הפרויקט, התדריך מתחיל בדפים מוצמדים, כללים ו־slots. דפים שלא נכנסים לתקציב מוצגים לקריאה דרךmemory_read_page. כדי למסור תדריך מוגבל גם לסוכני משנה של Claude Code, הגדירו בנפרדinject_on_subagent_start = true.ה-lint מציע קידום
כשכלל נראה יציב מספיק,
memory_lintמציע להעתיק אותו ל-CLAUDE.mdאו ל-AGENTS.md. ai-memory אף פעם לא עורך את הקבצים האלה בעצמו.רשומות ההחלטות נשארות שלכם
השרת אינו קורא או כותב קבצים במאגר שלך. סוכנים ופקודות הגדרה מקומיות יכולים לעשות זאת. שמור רשומות ADR במאגר;
[capture] ignore_pathsמצמצם לכידה שלהן דרך כלים, אך אינו מסנן פרומפטים או מבטיח החרגה.
# מוסיפים דפים מוצמדים, כללים ומשבצות לתחילת כל סשן
[briefing]
inject_on_session_start = true
הערות עם תוקף ומשוב על שימור
תזכור את זה עד יום שישי
דף עם
expires_atיוצא מהחיפוש הרגיל אחרי התאריך הזה. אפשר לכלול דפים שפג תוקפם בשאילתה עד שסריקת השימור מוחקת אותם, גם אם הם נעוצים.הדף הזה היה שגוי
memory_feedbackמתעד מועיל, לא מועיל, מיושן או שגוי. המשוב משפיע על שימור דפי סשן מתאימים; מיושן ושגוי גם מסמנים דפים לבדיקת lint. הוא אינו משנה את דירוג החיפוש ואינו מוחק דף ישירות.מעבירים סשן
סשן שנלכד בפרויקט הלא נכון, אחרי
cdלתיקיית scratch, אפשר לחבר מחדש עםai-memory move-session. התצפיות והדף שלו עוברים איתו.מתאוששים מצמצום הקשר
אחרי דחיסת הקשר, Claude Code, Codex ו-Factory Droid מקבלים עוגן קצר עם הפרומפט הראשון והאחרון של הסשן, במקום חבילת הפתיחה הרגילה. כל סוכן נושא גם כלל לקרוא מחדש את הפרומפטים של עצמו ולהעדיף אותם על פני התקציר.
reload contextעדיין מביא תקציר מוגבל ביוזמתכם.
קוראים בדפדפן, לוקחים לכל מקום
דפדפן לזיכרון שלך
לוח הבקרה המובנה מציג פרויקטים, תקינות לכידה, פעילות סוכנים ושימוש לכל תגובה. לשונית הידע כוללת מתארים, קישורים נכנסים, ראיות לפי גרסה וחיפוש; המדריכים נמצאים ב־/web/docs.
היסטוריה והשמעה חוזרת
כל דף מקשר לגרסאות שלו, עם diff בין כל שתיים, וכל סשן פותח ציר זמן של התצפיות שלו לפי סדר הלכידה. root רואה דף בריאות עם מוני ה-hooks והתיקון לכל מה שנכשל.
פורמט פתוח
כל פרויקט הוא bundle של Open Knowledge Format.
ai-memory export-okfאורז אותו לכל כלי שקורא OKF, ולכל השאר הקבצים הם markdown פשוט.Skills לסוכן שלכם
ai-memory install-mcpמתקין גם קטע ניתוב קצר ו-Agent Skills מנוהלים, כך שהסוכן יודע איזה כלי עונה על "דיברנו כבר על זה?" ואיזה שולח הודעות.
המטלות שה-launcher לוקח על עצמו
ai-memory run מפעיל את הסוכן דרך שרת הזיכרון. במעבר בין harnesses, הוא יכול להעביר גם קובץ זמני פרטי של ההיסטוריה הגלויה מהסוכן הקודם במחשב הזה. הנתיב והתוכן נשארים נייטיב; הקובץ נמחק כשהתהליך הבן מסתיים. ללא תמליל מקומי שמיש, נשארים היומן הנייד וה-handoff.
ai-memory run
הצעת ארגז חול
שדרוג עצמי
סגירה ביציאה
כניסה לאתר
שדרוג בפקודה אחת
ai-memory upgradeמוריד את הגרסה המתאימה, בודק את ה-checksum, מחליף את הקובץ הבינארי ומרענן את ה-hooks. התקנות Docker, Homebrew, AUR ו-RPM שומרות על המסלול שלהן.אזהרה לפני שההגנות יורדות
ai-jail ב-GitHubai-memory run --yoloאומר מה הוא עומד לנטרל, וב-Linux וב-macOS עם ai-jail זמין, מציע להריץ מחדש את הסשן בתוך ה-sandbox עם checklist של מה שהסשן המגודר יכול לראות.--jailנכנס ישר פנימה עם ברירות מחדל סבירות.סביבה בשביל ה-harness
--env KEY=VALUEו---env-fileמגיעים גם לסוכן שמופעל וגם לחיפוש הסשן העצמי של ai-memory, כך ש-CLAUDE_CONFIG_DIRלכל חשבון לא צריך script wrapper.סשנים נסגרים ביציאה
סוכנים בלי hook של סיום סשן (Command Code, Kiro CLI, Antigravity CLI) מקבלים את הסיכום וההעברה שלהם כש-launcher יוצא.
finalize-session --reopenמכסה שיחה שהמשיכה אחרי זה.התחברות לממשק ה-web
בוויקי המובנה יש דפי login והחלפת סיסמה למשתמשי סיסמה, ודף שרק ל-root יש גישה אליו לאישור או דחייה של הצעות auto-improvement ממתינות על פני כל הפרויקטים.
Stopwords בשפה שלכם
[search.fts] stopwordsמפרט את מילות הפונקציה של השפה שלכם, כך שדירוג טקסט מלא בוויקי בפורטוגזית לא מוטה על ידיdeו-que.
שאלות ותשובות
סוכן בפרויקט אחד יכול לקרוא את הזיכרון של פרויקט אחר?
כן, באמצעות שאילתות מפורשות בין פרויקטים, כשלקורא יש גישה. שאילתות רגילות משתמשות בפרויקט הנוכחי. הודעות מעבירות בקשה עצמאית ל-inbox של פרויקט אחר; הן לא מעניקות לנמען גישה לקבצים של השולח.
הודעה שהתקבלה מטופלת כהוראות?
לא. הודעה שנמשכה מגודרת כקלט לא מהימן מפרויקט אחר ונושאת הערה שאומרת את זה. הסוכן בוחן אותה איתכם כבקשת משימה, והשולח מוצג מחוץ לגדר כדי שתוכלו לשפוט קודם אם לסמוך עליו.
מה קורה אם שני סשנים בודקים את אותו inbox?
המשיכה הראשונה תופסת את ההודעה והשנייה לא מקבלת כלום. הודעה נתפסת פעם אחת בדיוק, אותו כלל שחל על העברות.
חייבים להגדיר workspaces?
לא. בלי קובץ סימון הכול מתויק תחת workspace בשם default, עם ה-git remote בתור הפרויקט, או שם התיקייה כשאין remote. מוסיפים .ai-memory.toml רק כשרוצים הפרדה בין לקוחות, mono-repo כפרויקט אחד, הפרדה בין זיכרון עבודה לזיכרון אישי, או שרת שני.
חיבור הכלים והוויקי של הצוות
בדיקת דפים משותפים במאגר שלך
הרכיב האופציונלי ai-memory-wikisync מסנכרן משפחות נבחרות של דפים משותפים עם Markdown במאגר. הוא מדווח על התנגשויות, משתמש בכתיבות מותנות ודורש הפעלה מפורשת למחיקות. הוא אינו משכפל שרתים או היסטוריית סשנים פרטית.
להכניס לזיכרון מסמך שכבר יש לכם
ה-ai-memory-importer האופציונלי קורא קובץ מקומי אחד שמצביעים עליו: markdown, PDF עם שכבת טקסט, DOCX, PPTX, XLSX, CSV, VTT או SRT. הוא כותב דף אחד עם ייחוס למקור, רץ כ-dry run כברירת מחדל, רושם את ה-digest של הקובץ ולעולם לא מחליף דף שאינו שלו. בלי OCR, בלי תמונות, בלי אודיו. הוא גם מייבא מסד נתונים של claude-mem מתוך תצלום לקריאה בלבד, עם מיפוי מפורש של פרויקטים והרצה יבשה תחילה.
תנו לסוכנים שלכם זיכרון, כבר היום.
חינמי וקוד פתוח ברישיון MIT. יכולות הזיכרון הבסיסיות לא דורשות מפתח API למודל; סוכן הקוד עשוי לדרוש חשבון משלו.