התקנה מהירה

מתקינים את הקובץ הבינארי

mise מוריד את ארכיון הגרסה שמתאים למערכת ההפעלה ולמעבד שלכם, ובודק אותו מול קובץ ה-.sha256 שפורסם. לא צריך toolchain של Rust ולא צריך Docker.

mise use -g github:akitaonrails/ai-memory

יוצרים את תיקיית הנתונים ומעלים את השרת

init רק יוצר את תיקיית הנתונים. serve צריך להישאר רץ, אז נותנים לו טרמינל משלו. הוא מאזין רק במחשב הזה ולא צריך טוקן.

ai-memory init
ai-memory serve --transport http --bind 127.0.0.1:49374

מפעילים דרכו את הסוכן

ההפעלה הראשונה של harness מתקינה את ה-hooks ואת רשומת ה-MCP שלו אם הם חסרים. גם אחר כך, הפעלה ישירה של claude ממשיכה לעבוד.

ai-memory run claude

מתקינים את החבילה

חבילת ה--bin היא קובץ בינארי מוכן ל-x86_64 או ל-aarch64. שתי החבילות מגיעות עם יחידת משתמש ויחידת מערכת של systemd.

yay -S ai-memory-bin    # קובץ בינארי מוכן ל-Linux x86_64/aarch64
yay -S ai-memory        # נבנה מקוד המקור

יוצרים את תיקיית הנתונים

mkdir -p ~/.config/ai-memory ~/.local/share/ai-memory
ai-memory --data-dir ~/.local/share/ai-memory \
  --config ~/.config/ai-memory/config.toml init

מפעילים את שירות המשתמש

לא צריך sudo, וכל ה-state נשאר בתיקיית הבית שלכם. החלק על שירותים מכסה את יחידת המערכת והרצה גם אחרי logout.

systemctl --user enable --now ai-memory.service

מפעילים דרכו את הסוכן

ai-memory run claude

מורידים ומחלצים

הארכיון הזה מיועד ל-Apple Silicon. ב-Mac עם Intel מחליפים את aarch64 ב-x86_64. הורדה דרך הדפדפן דורשת פעם אחת xattr -d com.apple.quarantine ./ai-memory. הורדה עם curl לא דורשת.

mkdir -p ~/Applications/ai-memory && cd ~/Applications/ai-memory
curl -fsSL -O https://github.com/akitaonrails/ai-memory/releases/latest/download/ai-memory-macos-aarch64.tar.gz
tar -xzf ai-memory-macos-aarch64.tar.gz

יוצרים את תיקיית הנתונים ומעלים את השרת

משאירים את serve רץ בטרמינל הזה. לחלופין, ה-launchd agent מעלה אותו בכניסה למערכת.

./ai-memory init
./ai-memory serve --transport http --bind 127.0.0.1:49374

מחברים את הסוכן מטרמינל שני

משאירים את הקובץ הבינארי שחולץ במקומו, כי פקודות ה-hooks מצביעות על הנתיב הזה.

cd ~/Applications/ai-memory
./ai-memory install-hooks --agent claude-code --apply
./ai-memory install-mcp --client claude-code --apply

מתקינים את סקריפט ה-wrapper

ה-wrapper הוא סקריפט shell קטן שמותקן ב-~/.local/bin/ai-memory. ב-README נמצא סקריפט ההתקנה, שבודק את ההורדה מול קובץ ה-SHA-256 שלה לפני שהוא מתקין אותה. מעתיקים אותו משם.

מעלים את השרת

ה-image מכסה את linux/amd64 ואת linux/arm64. על מכונה עם Podman מחליפים את docker ב-podman. כש-Docker לא מותקן, ה-wrapper משתמש מעצמו ב-Podman במצב rootless.

docker run -d --name ai-memory \
    --restart unless-stopped \
    -p 127.0.0.1:49374:49374 \
    -v ai-memory-data:/data \
    docker.io/akitaonrails/ai-memory:latest

מחברים את הסוכן

אחרי זה מפעילים את Claude Code כרגיל. למסלול הזה יש מגבלה אחת: ה-hooks של ה-wrapper, שכתובים ב-shell, לא אוכפים את כללי הלכידה ignore_paths שמוגדרים לכל repository. הקובץ הבינארי הנייטיב כן אוכף אותם.

ai-memory install-mcp   --client claude-code --apply
ai-memory install-hooks --agent  claude-code --apply

מחליטים איפה הסוכן רץ

סוכן שמופעל בתוך WSL2 צריך את ai-memory בתוך WSL2. המסלול הזה נתמך וזהה ללשונית של Docker: מתקינים את ה-wrapper מה-README ב-shell של WSL2. עם Docker Desktop, קודם מפעילים את ה-WSL integration עבור ההפצה.

מעלים את השרת בתוך WSL2

docker run -d --name ai-memory \
    --restart unless-stopped \
    -p 127.0.0.1:49374:49374 \
    -v ai-memory-data:/data \
    akitaonrails/ai-memory:latest

מחברים את הסוכן, גם הוא בתוך WSL2

Windows נייטיב הוא ניסיוני. יש לו zip של הגרסה עם ai-memory.exe, wrapper ל-Docker ב-PowerShell ומתכון לשירות WinSW. שלושתם נמצאים במדריך ל-Windows.

ai-memory install-mcp --client claude-code --apply
ai-memory install-hooks --agent claude-code --apply