📘 תיעוד 25

תחילת העבודה

Grok Build הוא עוזר תכנות AI מבוסס מסוף מבית SpaceXAI. הוא פועל כ-TUI (ממשק משתמש טרמינלי) שמבין את בסיס הקוד שלך, מריץ פקודות מעטפת, עורך קבצים, מחפש באינטרנט ומנהל משימות.

באפשרותך להשתמש בו באופן אינטראקטיבי כ-TUI במסך מלא, להריץ אותו ללא ממשק (headless) עבור סקריפטים ו-CI/CD, או לשלב אותו בעורכים באמצעות Agent Client Protocol (ACP).

#התקנה

התקן את הגרסה היציבה האחרונה (macOS, Linux, או Windows באמצעות Git Bash):

curl -fsSL https://x.ai/cli/install.sh | bash

התקן גרסה ספציפית:

curl -fsSL https://x.ai/cli/install.sh | bash -s 0.1.42

ב-Windows (PowerShell), השתמש במתקין ה-PowerShell המקורי:

irm https://x.ai/cli/install.ps1 | iex

התקן גרסה ספציפית:

$env:GROK_VERSION="0.1.42"; irm https://x.ai/cli/install.ps1 | iex

מתקין ה-PowerShell מוסיף באופן אוטומטי את %USERPROFILE%\.grok\bin ל-PATH של המשתמש שלך. לחלופין, התקן דרך Git for Windows (Git Bash) או MSYS2 באמצעות סקריפט ה-bash שלמעלה. משתמשי WSL מקבלים את הבינארי של Linux באופן אוטומטי.

אמת את ההתקנה:

grok --version

עדכן לגרסה האחרונה בכל עת:

grok update

כדי להביא מאגר דרך Grove (NFS ב-macOS, FUSE ב-Linux), הפעל את grok clone באמצעות [clone] enabled = true בהגדרות Grove, GROK_CLONE=1, או אפשרות הנוחות שמפעילה את שתיהן GROK_GROVE=1 / [cli] grove = true בתוך ~/.grok/config.toml:

grok clone <url> [dir]

ברירת המחדל היא checkout בעומק 1 (depth-1) של הענף שנבחר. העבר את --full-history עבור clone מלא. הפעלת clone אינה תלויה ב-worktrees של Grove עבור הפעלה (session) / -w (אפשרות הנוחות שלמעלה מפעילה את שניהם, אך ההגדרות הספציפיות עדיין קובעות). אישורי Git עבור השרת המרוחק מגיעים מה-daemon של Grove, ולא מההתחברות ל-grok.com שלהלן: ראה grok clone ו-Configuration reference.

#הפעלה ראשונה

הפעל את Grok על ידי הרצה:

grok

בהפעלה הראשונה, Grok פותח את הדפדפן שלך כדי לבצע אימות מול grok.com. לאחר שתתחבר, Grok שומר את פרטי האימות שלך ב-~/.grok/auth.json, שם הם נשמרים בין הפעלות. Grok מרענן את פרטי האימות שלך באופן אוטומטי ומבקש ממך להתחבר שוב כאשר כבר לא ניתן לחדש אותם.

אם אתה מעדיף אימות באמצעות מפתח API (למשל, עבור CI/CD או סביבות ללא דפדפן), הגדר במקום זאת את משתנה הסביבה XAI_API_KEY:

export XAI_API_KEY="xai-..."
grok

ראה Authentication עבור הסט המלא של אפשרויות אימות כולל OIDC, ספקי אימות חיצוניים, ו-device code flow.

#אינטראקציה בסיסית

לאחר האימות, Grok מציג TUI במסך מלא עם שני אזורים עיקריים:

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

הקלד הודעה ולחץ על Enter כדי לשלוח אותה. Grok קורא קבצים, מריץ פקודות ועורך קוד לפי הצורך. כל הרצת כלי מוזרמת ל-scrollback בזמן אמת.

לחץ על Tab כדי להעביר את המיקוד בין ה-prompt ל-scrollback. בזמן שתור רץ, Ctrl+C מבטל אותו ברגע שה-composer ריק. כאשר יש טיוטה, הלחיצה הראשונה רק מנקה אותה. המקש Esc לעולם אינו מבטל תור: באמצע תור הוא מציג תזכורת להשתמש ב-Ctrl+C. במצב המתנה (Idle), לחץ על Esc פעמיים בתוך 800 מילי-שניות כדי לנקות prompt שאינו ריק, או (כאשר ה-prompt ריק ויש הודעות בשיחה) כדי לפתוח rewind: ראה Keyboard Shortcuts. כאשר המיקוד ב-scrollback, השתמש במקשי החצים כדי לבחור רשומות וכדי לכווץ או להרחיב אותן. כדי לנווט באמצעות j/k ולקפל באמצעות h/l במקום זאת, הפעל את מצב Vim.

#הפניות לקבצים

השתמש ב-@ ב-prompt שלך כדי לצרף קבצים:

@src/main.rs              
# Attach a file
@src/main.rs:10-50        
# Attach lines 10-50
@src/                     
# Browse a directory

האופרטור @ פותח בורר קבצים בחיפוש מטושטש (fuzzy file picker). כברירת מחדל הוא מתחשב ב-.gitignore ומסתיר קבצים המתחילים בנקודה. הוסף קידומת ! כדי לחפש בקבצים מוסתרים:

@!.github                 
# Search hidden files
@!.env                    
# Attach a .env file

#הרשאות

כברירת מחדל, Grok מבקש הרשאה לפני ביצוע פקודות מעטפת או עריכת קבצים. באפשרותך לאשר כל פעולה בנפרד או להחליף את מצב always-approve:

• לחץ על Ctrl+O כדי להחליף את מצב always-approve
• השתמש בדגל --yolo בעת ההפעלה: grok --yolo
• הקלד /always-approve ב-prompt כדי להחליף את המצב

#מושגי מפתח

#Sessions

כל שיחה היא session. הפעלות (Sessions) נשמרות אוטומטית ב-~/.grok/sessions/ וניתן לחדש אותן מאוחר יותר. כל session עוקב אחר היסטוריית השיחה המלאה, קריאות לכלים, עריכות קבצים ומצב המשימות.

• התחלת session חדש: Ctrl+N או /new
• חידוש session קודם: /resume ב-TUI, או --resume <ID> מה-CLI
• המשך ה-session האחרון: grok -c

#Scrollback

ה-scrollback הוא אזור התצוגה הראשי. הוא מציג:

• User prompts: ההודעות שלך, המוצגות ככותרות דביקות (sticky headers)
• Agent messages: התגובות של Grok עם עיבוד markdown מלא והדגשת תחביר
• Thinking blocks: תהליך החשיבה של Grok (ניתן לכיווץ)
• Tool calls: עריכות קבצים (עם diffs מוטבעים), הרצות פקודות, תוצאות חיפוש ועוד
• Task lists: פריטי TODO העוקבים אחר התקדמות

כווץ או הרחב את הרשומה שנבחרה באמצעות מקשי החצים Left/Right (או h/l ו-e במצב Vim). במצב Vim, לחץ על y כדי להעתיק את התוכן שלה ועל Y כדי להעתיק את המטא-דאטה שלה (לדוגמה, הפקודה שרצה). לחץ על Enter כדי לפתוח אותה במציג מסך מלא (בכל מצב).

#כלים

ל-Grok יש כלים מובנים עבור:

ניתן להרחיב את הכלים באמצעות שרתי MCP עבור אינטגרציות כמו GitHub, מסדי נתונים ועוד.

#פקודות סלאש (Slash Commands)

הקלד / ב-prompt כדי לגשת לפקודות. אלו מספקות פעולות מהירות מבלי לכתוב prompt מלא:

/model grok-4.6                 
# Switch model
/compact                          
# Compress conversation history
/always-approve                   
# Toggle always-approve mode
/new                              
# Start a new session

ראה Slash Commands לעיון במדריך המלא.

#אפשרויות הפעלה נפוצות

# Launch the interactive TUI and submit an initial prompt as the first turn
grok "fix the failing auth test and run it"

# Initial prompt in a new git worktree. Use --worktree=<name> (with `=`) so the
# prompt isn't swallowed as the worktree name: `grok -w "refactor module X"`
# would treat "refactor module X" as the worktree label, not the prompt.
grok --worktree=feat "refactor module X"

# Base the worktree on a specific branch (e.g. main) instead of the current HEAD:
grok -w --ref main "implement feature from main"


# Start in a specific project directory
grok --cwd ~/projects/my-app

# Add project-specific rules
grok --rules "Always use TypeScript. Prefer functional components."

# Auto-approve all tool executions
grok --yolo

# Use a specific model
grok -m grok-4.6

# Resume a previous session
grok --resume <session-id>

# Continue the most recent session
grok -c

# Experimental scrollback-native render mode. Sticky: plain `grok` reopens in
# the mode last chosen via --minimal/--fullscreen (or /minimal//fullscreen).
grok --minimal

# Back to the standard fullscreen TUI (and make it sticky again)
grok --fullscreen

# Headless mode (for scripts)
grok -p "Explain this codebase"

#מצב ללא ממשק (Headless Mode)

הפעל את Grok באופן לא אינטראקטיבי עבור סקריפטים, CI/CD ואוטומציה:

grok -p "Your prompt here"

פורמטים של פלט:

דוגמה לשימוש ב-CI/CD:

grok -p "Review changes for bugs" --output-format json --yolo | jq -r '.text'

#כללי פרויקט (AGENTS.md)

הוסף הנחיות לפי פרויקט על ידי יצירת קובץ AGENTS.md במאגר שלך. Grok קורא קבצים אלה ומזריק את תוכנם כהודעת project-instructions בתחילת השיחה:

~/.grok/AGENTS.md           
# Global rules (apply to all projects)
<repo-root>/AGENTS.md       
# Repository-level rules
<cwd>/AGENTS.md             
# Directory-level rules (highest priority)

קבצים עמוקים יותר מקבלים קדימות. Grok קורא גם קובצי CLAUDE.md לצורך תאימות.

#לאן להמשיך מכאן