קורן בן עזרא
yamadashy (Kazuki Yamada)מה זה Repomix?
Repomix הוא כלי שורת פקודה בקוד פתוח שלוקח תיקיית קוד שלמה, או מאגר ב-GitHub, ואורז אותה לקובץ אחד שמודל שפה יכול לקרוא בבת אחת. הוא סופר טוקנים, מכבד את .gitignore, מסנן קבצים שנראים כמו סיסמאות ומפתחות, ויכול לעבוד גם כשרת MCP או כפלאגין בתוך Claude Code.
כשרוצים ש-Claude יבין פרויקט שלם, למשל כדי לסקור קוד שקיבלתם מפרילנסר או לתעד מערכת ישנה, צריך להעביר לו הרבה קבצים בצורה מסודרת. Repomix עושה את זה בפקודה אחת: הוא עובר על התיקייה, מדלג על מה שמופיע ב-.gitignore, ב-.ignore וב-.repomixignore, ומייצר קובץ בשם repomix-output.xml עם סיכום, מבנה תיקיות ותוכן כל הקבצים. את הקובץ הזה אפשר להעלות ל-Claude.ai או לכל מודל אחר, ולשאול עליו שאלות.
מעבר לאריזה הבסיסית יש כמה יכולות שימושיות במיוחד. ספירת טוקנים לכל קובץ ולכל הפרויקט עוזרת לדעת מראש אם הקובץ ייכנס לחלון ההקשר של המודל. האפשרות --compress משתמשת ב-Tree-sitter כדי להשאיר רק את מבנה הקוד (מחלקות, פונקציות וממשקים), ובדיקת האבטחה עם Secretlint משאירה בחוץ קבצים שנראים כמו מפתחות או סיסמאות. אפשר לארוז גם מאגר מרוחק עם --remote, בלי לשכפל אותו קודם.
בעבודה עם Claude Code יש ל-Repomix שלוש דרכים להשתלב. אפשר להגדיר אותו כשרת MCP, ואז Claude יכול לארוז, לקרוא ולחפש בתוך קוד בעצמו. אפשר להתקין את הפלאגינים הרשמיים מהמרקטפלייס של Repomix, שמוסיפים פקודות וסוכן לניתוח ריפו. ויש גם אפשרות --skill-generate שהופכת כל ריפו לסקיל של Claude, כך שהקוד של ספרייה שאתם עובדים איתה הופך למקור ידע קבוע. חשוב לדעת שהכלי דורש Node.js בגרסה 22 ומעלה.
למי זה מתאים
- בעלי עסקים שקיבלו קוד מספק חיצוני ורוצים ש-Claude יסביר או יסקור אותו
- סוכנויות שמקבלות לתחזוקה אתרים ומערכות ישנות וצריכות להבין אותם מהר
- מפתחים שרוצים להעביר פרויקט שלם ל-Claude.ai, ל-ChatGPT או ל-Gemini
- מי שרוצה להפוך ספרייה או מאגר קוד לסקיל קבוע של Claude
מה הוא עושה
קובץ אחד לכל הפרויקט
פקודה אחת מייצרת קובץ עם סיכום, מבנה תיקיות ותוכן הקבצים, בפורמט XML (ברירת מחדל), Markdown, JSON או טקסט רגיל.
ספירת טוקנים
Repomix מציג כמה טוקנים יש בכל קובץ ובפרויקט כולו, ועם --token-count-tree אפשר לראות איפה הקבצים הכבדים. עם --token-budget הוא מחזיר שגיאה כשהפלט גדול מדי.
סינון סודות
בדיקת האבטחה המובנית עם Secretlint מזהה קבצים שתואמים לפורמטים מוכרים של מפתחות וסיסמאות ומשאירה אותם מחוץ לפלט.
דחיסה חכמה
--compress משתמש ב-Tree-sitter כדי להשאיר רק מבנה: מחלקות, פונקציות וממשקים. לפי ה-README זה חוסך כ-70 אחוז מהטוקנים ושומר על המשמעות.
מאגרים מרוחקים
--remote יחד עם כתובת GitHub או בקיצור user/repo אורז מאגר בלי לשכפל אותו ידנית, ואפשר לבחור ענף, תגית או commit.
שרת MCP
במצב --mcp Claude מקבל כלים כמו pack_codebase, pack_remote_repository, read_repomix_output ו-grep_repomix_output, וארוז וקורא קוד בעצמו.
יצירת סקיל מריפו
--skill-generate מייצר תיקיית סקיל עם SKILL.md וקובצי reference (סיכום, מבנה, קבצים וטכנולוגיות), ב-~/.claude/skills או בתיקיית .claude/skills של הפרויקט.
הרבה דרכי שימוש
מלבד שורת הפקודה יש אתר ב-repomix.com, תוסף לכרום ולפיירפוקס שמוסיף כפתור בעמודי GitHub, ותוסף קהילתי ל-VS Code.
דוגמאות שימוש
מה כותבים ל-Claude אחרי ההתקנה, ומה מקבלים.
סקירת קוד שקיבלתם מפרילנסר
תריץ npx repomix@latest בתיקיית הפרויקט, ואחר כך תקרא את repomix-output.xml ותכין לי סקירה בעברית: מה הקוד עושה, איפה נקודות התורפה ומה הייתי צריך לשאול את הפרילנסר.מה מקבלים: קובץ ארוז של הפרויקט וסקירה מסודרת שמבוססת על כל הקוד ולא רק על כמה קבצים.
הבנת מאגר קוד פתוח
/repomix-explorer:explore-remote yamadashy/repomix Show me the main architecture and where the CLI options are defined.
מה מקבלים: ניתוח של המאגר המרוחק דרך הפלאגין repomix-explorer, בלי לשכפל אותו ובלי להעמיס את כל הקוד על ההקשר.
העלאה ל-Claude.ai
תארוז רק את תיקיית src ואת קובצי ה-Markdown, בלי קובצי בדיקות, בפורמט markdown ועם דחיסה, ותגיד לי כמה טוקנים יצאו.מה מקבלים: הרצה של repomix --include "src/**,**/*.md" --ignore "**/*.test.*" --style markdown --compress וקובץ שמוכן להעלאה, עם ספירת טוקנים.
ספרייה כסקיל קבוע
תהפוך את הקוד של הספרייה בתיקייה vendor/payments לסקיל של Claude בשם payments-reference, כדי שתוכל לחזור אליו בכל פעם שאני שואל על תשלומים.מה מקבלים: תיקיית סקיל עם SKILL.md וקובצי reference שנוצרה עם --skill-generate, זמינה בסשנים הבאים.
מה צריך לפני שמתחילים
- Node.js בגרסה 22 ומעלה (כך מוגדר ב-package.json של הכלי)
- Claude Code, אם רוצים לעבוד עם MCP או עם הפלאגינים. הקובץ הארוז עצמו מתאים לכל מודל
- אין מפתחות API ואין עלות. רישיון MIT
- בפרויקטים גדולים הקובץ יכול להיות גדול מחלון ההקשר של המודל. משתמשים באפשרויות --compress, --include או --split-output
אין עדיין Claude Code? במדריך הזה יש התקנה צעד אחרי צעד.
איך מתקינים את Repomix.
יש 3 דרכים, ומספיקה אחת מהן. הראשונה הכי פשוטה.
הדרך הקלה: מדביקים בצ'אט של Claude Code
פותחים שיחה חדשה ב-Claude Code, מעתיקים את ההודעה ומדביקים. כש-Claude מבקש אישור להריץ, לוחצים Allow.
תגדיר לי את Repomix כשרת MCP ב-Claude Code לכל הפרויקטים. תריץ את הפקודה הבאה ותגיד לי כשהיא מסתיימת, ואז אפעיל מחדש את Claude Code:
claude mcp add -s user repomix -- npx -y repomix --mcpדרך הפלאגינים של Claude Code
מקלידים בצ'אט של Claude Code את שתי הפקודות, אחת אחרי השנייה. את הפקודות מקלידים בעצמכם בחלון של Claude Code. repomix-mcp הוא הבסיס המומלץ. אפשר להוסיף גם /plugin install repomix-commands@repomix לפקודות pack-local ו-pack-remote, ו-/plugin install repomix-explorer@repomix לסוכן שמנתח ריפו. לא צריך להגדיר גם MCP ידני וגם את repomix-mcp, בוחרים אחד.
/plugin marketplace add yamadashy/repomix
/plugin install repomix-mcp@repomix
בטרמינל, ידנית
למי שמעדיף להריץ בעצמו. מעתיקים לטרמינל ומריצים.
npm install -g repomix claude mcp add -s user repomix -- npx -y repomix --mcp
צריך להפעיל מחדש את Claude Code כדי ששרת ה-MCP ייטען. ההתקנה הגלובלית עם npm היא לשימוש ישיר בטרמינל, ושרת ה-MCP עצמו רץ דרך npx ולא תלוי בה. ב-README הפקודה מופיעה בלי -s user, ואז היא מוגדרת רק לפרויקט הנוכחי.
- בטרמינל מריצים claude mcp list ובודקים ש-repomix מופיע ומחובר
- בתוך Claude Code מקלידים /mcp ורואים את repomix ברשימת השרתים
- בודקים בפועל: "תארוז את התיקייה הנוכחית עם repomix ותגיד לי כמה טוקנים יש"
- לכלי שורת הפקודה: repomix --version
שרת ה-MCP רץ עם npx, ולכן כדי לוודא שמגיעה הגרסה האחרונה אפשר להגדיר אותו עם repomix@latest, כמו בפלאגין הרשמי. את הכלי הגלובלי מעדכנים עם npm install -g repomix@latest, ואת הפלאגינים עם claude plugin update repomix-mcp@repomix.
claude mcp remove -s user repomix && npm uninstall -g repomix
איך משתמשים ביום יום
- הדרך הכי פשוטה: בתיקיית הפרויקט מריצים npx repomix@latest ומקבלים repomix-output.xml.
- מעלים את הקובץ ל-Claude.ai עם בקשה כמו "הקובץ הזה מכיל את כל הקבצים בפרויקט. אני רוצה לעשות refactor, תסקור אותו קודם", כמו בדוגמה שב-README.
- ב-Claude Code עם MCP פשוט מבקשים "תארוז את הפרויקט ותנתח אותו", ו-Claude קורא לכלים של Repomix בעצמו.
- למאגר מרוחק: repomix --remote user/repo, או בפלאגין /repomix-commands:pack-remote user/repo.
- להפיכת ריפו לסקיל: repomix --skill-generate, ו-Repomix ישאל אם לשמור ב-~/.claude/skills או בתיקיית הפרויקט.
טיפים שימושיים
- לפני העלאה של קובץ ארוז לשירות חיצוני, בדקו מה נכנס. Secretlint מסנן פורמטים מוכרים של מפתחות, אבל לא כל מידע רגיש.
- בפרויקט גדול התחילו עם --compress או עם --include לתיקייה אחת. כך הקובץ קטן, זול יותר ומדויק יותר.
- --copy מעתיק את הפלט ישר ללוח, נוח כשמדביקים לצ'אט.
- שמרו הגדרות קבועות בקובץ repomix.config.json, שנוצר עם repomix --init.
תקלות נפוצות
Repomix נכשל עם שגיאה על גרסת Node
שרת ה-MCP לא מופיע ב-Claude Code
הקובץ הארוז גדול מדי למודל
קובץ מסוים לא נכנס לפלט
שאלות ותשובות
Repomix הוא סקיל?
הקוד שלי נשלח לאנשהו?
זה עובד עם מודלים אחרים חוץ מ-Claude?
כמה זה עולה?
כמה פופולרי הכלי?
קרדיט ומקור. Repomix נכתב על ידי yamadashy (Kazuki Yamada) ונמצא ב-yamadashy/repomix ברישיון MIT. את העמוד כתב קורן בן עזרא אחרי בדיקה של המאגר ושל פקודות ההתקנה (29.09.2026). מאגרים מתעדכנים, ולכן אם משהו השתנה, המאגר הוא המקור הקובע.
obra
Anthony Fu
yusufkaraaslan