Skip to content

ערוץ CLI

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

סיווג

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

מדוע INTERNAL? ה-CLI הוא ממשק ישיר ומקומי. רק מי שיש לו גישה

לטרמינל שלכם יכול להשתמש בו. זה הופך את INTERNAL לברירת מחדל המתאימה -- הסוכן יכול לשתף נתונים פנימיים בחופשיות בהקשר זה. :::

תכונות

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

ה-CLI משתמש במצב טרמינל גולמי עם ניתוח מלא של רצפי ANSI escape. זה נותן לכם חוויית עריכה עשירה ישירות בטרמינל:

  • עריכת שורה -- ניווט עם מקשי חצים, Home/End, מחיקת מילים עם Ctrl+W
  • היסטוריית קלט -- לחצו Up/Down לסיבוב בין קלטים קודמים
  • הצעות -- השלמת Tab לפקודות נפוצות
  • קלט רב-שורתי -- הזינו פרומפטים ארוכים יותר באופן טבעי

תצוגת כלים קומפקטית

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

tool_name arg  result

החליפו בין תצוגת כלים קומפקטית ומורחבת עם Ctrl+O.

הפסקת פעולות רצות

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

תצוגת זיהום

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

[CONFIDENTIAL] הנה מספרי צינור ה-Q4 שלך...

סרגל התקדמות אורך הקשר

ה-CLI מציג סרגל שימוש בחלון הקשר בזמן אמת בשורת ההפרדה בתחתית הטרמינל:

[████████████░░░░░░░░] 62% ctx  MCP 3/3
  • הסרגל מתמלא ככל שטוקני הקשר נצרכים
  • סמן כחול מופיע בסף 70% (שבו דחיסה אוטומטית מופעלת)
  • הסרגל הופך לאדום כשמתקרבים למגבלה
  • לאחר דחיסה (/compact או אוטומטית), הסרגל מתאפס

סטטוס שרתי MCP

שורת ההפרדה מציגה גם את סטטוס חיבור שרתי MCP:

תצוגהמשמעות
MCP 3/3 (ירוק)כל השרתים המוגדרים מחוברים
MCP 2/3 (צהוב)חלק מהשרתים עדיין מתחברים או נכשלו
MCP 0/3 (אדום)אין שרתים מחוברים

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

היסטוריית קלט

היסטוריית הקלט שלכם נשמרת בין סשנים ב:

~/.triggerfish/data/input_history.json

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

קלט Non-TTY / מועבר בצינור

כאשר stdin אינו TTY (למשל, כאשר מעבירים קלט בצינור מתהליך אחר), ה-CLI עובר אוטומטית למצב מאגר שורות. במצב זה:

  • תכונות טרמינל גולמי (מקשי חצים, ניווט היסטוריה) מושבתות
  • קלט נקרא שורה אחר שורה מ-stdin
  • פלט נכתב ל-stdout ללא עיצוב ANSI

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

bash
echo "What is the weather today?" | triggerfish run

תצורה

ערוץ ה-CLI דורש תצורה מינימלית. הוא נוצר אוטומטית כאשר מריצים triggerfish run או משתמשים ב-REPL האינטראקטיבי.

yaml
channels:
  cli:
    interactive: true
    showTaint: false
אפשרותסוגברירת מחדלתיאור
interactivebooleantrueהפעלת מצב REPL אינטראקטיבי
showTaintbooleanfalseהצגת רמת זיהום סשן בפלט

ללא הגדרה נדרשת ערוץ ה-CLI עובד מיד. אין צורך להגדיר דבר

כדי להתחיל להשתמש ב-Triggerfish מהטרמינל. :::

קיצורי מקלדת

קיצורפעולה
Enterשליחת הודעה
Up / Downניווט בהיסטוריית קלט
Ctrl+Vהדבקת תמונה מלוח (נשלחת כתוכן רב-מודלי)
Ctrl+Oהחלפת תצוגת כלים קומפקטית/מורחבת
ESCהפסקת פעולה נוכחית
Ctrl+Cיציאה מה-CLI
Ctrl+Wמחיקת מילה קודמת
Home / Endקפיצה לתחילת/סוף שורה