עוד פקודות CLI

מעבר ל-init, ה-CLI מכסה ארבע משימות: התחברות ובחירת סביבת עבודה, בדיקה מה באמת חי, כתיבת האינטגרציה בשבילכם, וקריאת ההגדרות של סביבת העבודה מטרמינל או ממשימת CI.

התחברות והתנתקות

התחבר עם הדפדפן: ה-CLI פותח את לוח הבקרה, אתה מאשר את המכשיר, והפעלה מקושרת לחשבונך נשמרת ב-‎~/.syncanix/credentials (קריא רק לך) — ה-CLI פועל אז בתפקידך, במרחבי העבודה שלך. השתמש ב-‎--key למפתח מכונה של מרחב העבודה (CI; באישור מנהל), בדוק כמי אתה מחובר עם syncanix whoami, והתנתק עם syncanix logout — שגם מבטל את ההפעלה בצד השרת.

npx syncanix login
npx syncanix logout

בדקו מי אתם ולאן אתם כותבים

הפעלה פועלת בשמכם, ולכן אותה פקודה עשויה לכתוב לסביבת עבודה אחרת בהתאם לזו הפעילה. הפקודה syncanix whoami עונה על שתי השאלות יחד — הזהות שלכם, סביבת העבודה הפעילה והתפקיד שלכם בה, מתי ההפעלה פגה, וכל סביבה שבה אתם יכולים לפעול. התשובה מגיעה חיה מהשרת, ולכן היא גם בדיקה שההפעלה עדיין תקפה. הפקודה syncanix workspace list מציגה את אותה רשימה בנפרד, ו‑syncanix workspace use <slug> משנה לאן תיכתב הפקודה הבאה. הריצו whoami לפני כל העלאה.

npx syncanix whoami
npx syncanix workspace list
npx syncanix workspace use acme

ייבוא סכמה

כבר יש לכם סכמת OpenAPI או GraphQL? בנו ממנה קטלוג ישירות, ללא סריקת קוד. העבירו ‎--offline‎ כדי לדלג על העלאה, או ‎--env‎ כדי לכוון לסביבה.

npx syncanix import --openapi ./openapi.json
npx syncanix import --graphql ./schema.graphql

האם העותק שלי מסונכרן?

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

npx syncanix status

לתפוס שינוי לפני הלקוחות

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

npx syncanix drift

האם הווידג׳ט באמת בעמוד?

טוען כתובת ומדווח אם ההטמעה של Syncanix חיה בה. מהיר יותר מלפתוח דפדפן, ושימושי בבדיקת פריסה — הסיבה הנפוצה ביותר לצ׳אט חסר היא build שאיבד את תגית הסקריפט.

npx syncanix embed check https://app.acme.com

כתוב לי את קובצי האינטגרציה

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

npx syncanix generate

חיבור הווידג׳ט לפרונטאנד

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

npx syncanix integrate scan
npx syncanix integrate plan
npx syncanix integrate apply

לקרוא קטלוג מהטרמינל

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

npx syncanix catalog list --side-effect destructive
npx syncanix catalog diff ./before.json ./after.json
npx syncanix catalog compliance --format md

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

לקרוא מה מותר לסוכן

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

npx syncanix governance list
npx syncanix approvals
npx syncanix keys list

סביבת פיתוח מקומית

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

npx syncanix dev --port 4321

אבחון ההגדרה שלכם

בודק את הסביבה שלכם לאיתור בעיות נפוצות — גרסת Node, framework מזוהה, תצורה תקפה, ומפתח API שניתן לאיתור. הוא יוצא עם קוד שאינו אפס אם משהו שגוי.

npx syncanix doctor

רישום שרת MCP חיצוני

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

npx syncanix byomcp register --server-url https://mcp.example.com

שכבות קטלוג כקוד

נהלו שכבת ‎syncanix.yaml‎ מנוהלת-גרסאות: init יוצר אחת, validate בודק אותה, ו-apply ממזג אותה על קטלוג שהתגלה.

npx syncanix yaml init
npx syncanix yaml validate
npx syncanix yaml apply --catalog ./.syncanix/catalog.json

גרסה

מדפיס את גרסאות ה-CLI, Node והבנייה — שימושי בעת דיווח על בעיה.

npx syncanix version

השלבים הבאים