איך מנהלים את הקהילה מהטרמינל (CLI)

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

איפה זה:ניהולAI וחיבוריםחיבורים

מה זה ולמה צריך את זה

moadon הוא כלי שורת פקודה שמדבר עם הקהילה שלכם. הוא יודע לעשות את אותן פעולות ש-Claude עושה: לרשום תלמידים, לבנות קורסים, לפתוח אירועים, למשוך נתונים.

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

איך עושים את זה

  1. יוצרים מפתח API

    בניהול נכנסים ל"AI וחיבורים", "חיבורים", ובלשונית "מפתחות API" יוצרים מפתח חדש. מעתיקים אותו מיד, הוא מוצג רק פעם אחת.

    צילום מסך: יוצרים מפתח API
  2. מתקינים בפקודה אחת

    פותחים טרמינל ומריצים:

    curl -fsSL https://moadon.io/api/cli/install | bash

    הפקודה מורידה את moadon לתיקייה ~/.local/bin ואז מבקשת את המפתח. מדביקים אותו ולוחצים Enter. הוא לא מוצג על המסך בזמן ההדבקה, וזה בסדר: ככה הוא לא נשמר בהיסטוריה של הטרמינל. צריך Node בגרסה 18 ומעלה.

  3. בודקים את החיבור

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

  4. מוצאים את הפעולה שצריך

    moadon tools מציג את כל הפעולות. אפשר לסנן לפי מילה, למשל moadon tools course. כדי לראות אילו פרטים פעולה מסוימת צריכה מריצים moadon help ואז את שם הפעולה, למשל moadon help create-course.
  5. מריצים פעולה

    כותבים את שם הפעולה ואחריו הפרטים בצורת שם=ערך. למשל:

    moadon list-members limit=20
    moadon create-course title="יסודות העריכה"

    התשובה חוזרת כ-JSON, אז קל להעביר אותה לכלים אחרים. אם כתבתם שם של פרט שלא קיים, moadon עוצר ומראה אילו פרטים כן אפשר לשלוח.

כדאי לדעת

  • המפתח נשמר בקובץ שרק המשתמש שלכם במחשב יכול לקרוא. בשרת או באוטומציה עדיף להעביר אותו במשתנה הסביבה MOADON_API_KEY ולא לשמור אותו בקובץ.
  • מחיר, תקופת ניסיון, חיובים ודף התשלום לא משתנים מה-CLI, בדיוק כמו ב-Claude. רק מעמוד ההגדרות.
  • פעולות מחיקה ושליחה רצות מיד, בלי חלון אישור. לפני שמריצים לולאה על הרבה תלמידים, בודקים אותה על תלמיד אחד.
  • אין צורך לעדכן את הכלי כשמועדון מוסיף פעולות. הרשימה מגיעה מהשרת בכל הרצה.

שאלות ששואלים

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

מדריכים קרובים

משהו לא ברור, או חסר מדריך? כתבו לנו או חזרו לכל המדריכים.