המדריך ל-Graphify: לתת לעוזר הקוד מפה של הפרויקט

כשאתם מבקשים מ-Claude Code או מ-Cursor לשנות משהו בפרויקט, הם קוראים קבצים. אחד אחרי השני, ומחפשים מילים. זה עובד מצוין בפרויקט קטן.

בפרויקט גדול זה מתחיל להישבר. אתם שואלים איך הטופס בעמוד ההרשמה מחובר לטבלת המשתמשים, והעוזר סורק קבצים, מפספס חיבורים שלא כתובים בגלוי, ומחזיר תשובה חלקית שנשמעת בטוחה בעצמה.

הסיבה מבנית. לעוזר אין מפה של הפרויקט, יש לו רק קבצים.

וזה מה שהכלי הזה עושה. הוא סורק את הפרויקט והופך אותו לגרף, כלומר רשת של מושגים והקשרים ביניהם. במקום לחפש בקבצים, העוזר שואל את הרשת.

הכלי חינמי ובקוד פתוח, והוא אחד הפרויקטים הפופולריים בתחום הזה כרגע.

אני פותח בזה בכוונה, כי זה כלי מצוין שלא מתאים לכולם.

זה מתאים לכם אם הפרויקט שלכם גדול, נניח עשרות קבצים ומעלה. אם אתם עובדים עם עוזר קוד כמו Claude Code או Cursor. ואם אתם מוצאים את עצמכם מסבירים לו שוב ושוב איך הדברים מחוברים.

זה לא מתאים לכם אם הפרויקט שלכם קטן. אתר עם חמישה או עשרה קבצים, העוזר קורא את כולם בקלות, והגרף רק יוסיף לכם שלב בלי להוסיף ערך.

וגם אם אתם לא עובדים עם עוזר קוד בטרמינל, כי הכלי נועד להשתלב בתוך עוזר ולא לעמוד בפני עצמו. או אם אתם לא מרגישים בנוח עם טרמינל, כי צריך להתקין חבילה וזה דורש כמה פקודות.

תהיו כנים עם עצמכם בסעיף הזה. כלי טוב בפרויקט שלא צריך אותו הוא בזבוז זמן.

צריך את Python בגרסה 3.10 ומעלה. לבדיקה, פתחו טרמינל והריצו:

python --version

אם אין לכם, מורידים מאתר python.org.

בנוסף צריך מנהל חבילות שיתקין את הכלי בסביבה מבודדת. מומלץ uv, ואפשר גם pipx.

ההתקנה של uv:

# Mac
brew install uv

# Windows
winget install astral-sh.uv

# Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

וכמובן עוזר קוד מותקן. הכלי תומך ב-Claude Code, ב-Cursor, ב-Codex, ב-Gemini CLI, ב-GitHub Copilot ובעוד עשרות אחרים.

שם החבילה להתקנה הוא graphifyy, עם שתי אותיות y בסוף.

הפקודה שתריצו אחר כך נקראת graphify, עם y אחת. זה מבלבל וזה לא במקרה, כי השם הפשוט היה תפוס.

המפתחים של הכלי כותבים במפורש בעמוד הרשמי שחבילות אחרות בשם דומה אינן קשורות אליהם. כלומר אם תתקינו את השם הלא נכון, אתם מתקינים משהו אחר שאף אחד לא בדק.

תעתיקו את הפקודות מכאן ואל תקלידו אותן מהזיכרון.

השלב הראשון, מתקינים את החבילה:

uv tool install graphifyy

או, אם אתם עובדים עם pipx:

pipx install graphifyy

הימנעו מ-pip רגיל ב-Mac וב-Windows. הוא מתקין למקום אחר, וזו הסיבה הנפוצה ביותר לשגיאה שנראית כאילו הכלי לא הותקן בכלל.

השלב השני, מחברים לעוזר שלכם:

graphify install

זהו. הפקודה מזהה את Claude Code לבד. לעוזרים אחרים מוסיפים את השם:

graphify cursor install
graphify install --platform codex
graphify install --platform gemini
graphify antigravity install

פתחו את העוזר שלכם בתוך תיקיית הפרויקט, וכתבו:

/graphify .

הנקודה בסוף אומרת התיקייה הנוכחית. זה לוקח בערך חמש דקות בפרויקט בינוני.

מי שעובד ב-PowerShell בחלונות צריך לכתוב בלי הלוכסן בהתחלה. הלוכסן הוא תו מיוחד שם, וזה ייכשל. ומי שעובד ב-Codex משתמש בסימן דולר במקום בלוכסן.

מה שתקבלו בסוף זו תיקייה חדשה ובתוכה שלושה קבצים.

הראשון, קובץ HTML שאפשר לפתוח בדפדפן ולראות את הפרויקט כרשת. אפשר ללחוץ על כל נקודה ולראות למה היא מחוברת. זה החלק המרשים.

השני, דוח בשפה פשוטה שמסכם את המושגים המרכזיים ואת החיבורים המפתיעים.

והשלישי, קובץ נתונים שהעוזר שואל אותו מכאן והלאה.

אחרי שהגרף קיים, אתם שואלים אותו במקום לתת לעוזר לחפש בקבצים:

/graphify query "מה מחבר בין ההתחברות למסד הנתונים"
/graphify path "UserService" "DatabasePool"
/graphify explain "RateLimiter"

הראשונה שואלת שאלה חופשית. השנייה מראה את המסלול בין שני דברים. השלישית מסבירה מושג אחד ואת כל מה שמחובר אליו.

כשהקוד משתנה, מרעננים רק את מה שהשתנה:

/graphify . --update

ואם אתם רוצים שזה יקרה לבד אחרי כל שמירה:

graphify hook install

יש עוד דבר אחד ששווה להכיר. כל קשר בגרף מסומן באחת משתי דרכים, נמצא במפורש בקוד או הוסק. כלומר אתם תמיד יודעים מה נקרא ומה נוחש. זה נשמע פרט טכני, וזה בדיוק ההבדל בין כלי שאפשר לסמוך עליו לכלי שרק נשמע בטוח.

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

מסמכים, קובצי PDF, תמונות ווידאו זה סיפור אחר. אלה עוברים דרך המודל של העוזר שלכם, ולכן צורכים מהמכסה שלכם. אם אתם רוצים רק את הקוד ובלי הצריכה הזו, יש דגל שמדלג על השאר:

graphify extract . --code-only

והכלי עצמו חינמי לגמרי. בלי חשבון ובלי כרטיס אשראי.

graphify uninstall

ואם אתם רוצים גם למחוק את הגרף שנוצר:

graphify uninstall --purge

שורה תחתונה

זה כלי חזק וממוקד. הוא פותר בעיה אחת, שהעוזר לא מכיר את המבנה של פרויקט גדול, והוא פותר אותה טוב.

אם הפרויקט שלכם קטן, דלגו. ואם הוא גדול ואתם מוצאים את עצמכם מסבירים את אותו דבר לעוזר שוב ושוב, זה יחסוך לכם זמן אמיתי.

ותזכרו את שתי האותיות בסוף שם החבילה. זה הפרט היחיד כאן שאפשר לטעות בו בצורה שמזיקה.