מארחי Git
חברו את GitLab, Bitbucket, Azure DevOps, Gitea או Forgejo ל-Ingot, ותנו לסוכנים ערכת כלים אחת למאגרים, ל-pull requests, ל-issues ול-CI.
Beta מארחי Git היא תכונה אופציונלית, והיא כבויה עד שמפעילים אותה. היא עובדת עם שרתים בענן ועם שרתים באירוח עצמי: GitLab.com ו-GitLab Self-Managed או Dedicated, Bitbucket Cloud ו-Bitbucket Data Center (או Server), Azure DevOps Services ו-Azure DevOps Server, Gitea, Forgejo ו-Codeberg, וגם כל כתובת אחרת באירוח עצמי, שבה Ingot מזהה איזה מארח רץ. מתחברים עם טוקן גישה או עם OAuth. ל-GitHub יש שילוב משלו ב-Git.


הפעלה
את מארחי Git מוצאים בשלוש דרכים, כמו כל תכונה אופציונלית:
- הצעה בצ'אט. כשמזכירים GitLab, merge requests, Bitbucket, Azure DevOps, Gitea או Forgejo, או שואלים על pull requests, issues או CI כשה-
originשל הפרויקט נמצא באחד המארחים האלה, כרטיס קטן מעל תיבת הצ'אט מציע Enable Git Hosts. הכפתור × מסתיר אותו לתמיד. - Settings › Features › Git Hosts. מתג. כיבוי מסתיר את החלונית ומוריד את הכלים מהסוכנים; החשבונות נשארים מחוברים.
- הכפתור Git Hosts בשורת המצב. לחיצה אחת מפעילה את מארחי Git ופותחת את החלונית. כשהתכונה פעילה, הכפתור מציג או מסתיר את החלונית. קיצור המקלדת הוא
⌥⇧⌘\ב-macOS ו-Ctrl+Alt+Shift+\ב-Windows ו-Linux.






חיבור מארח
לחצו על Connect… בחלונית (או הריצו Git Hosts: Connect GitLab, Bitbucket, Azure DevOps, Gitea or Forgejo… מ-Find Action). בחרו מארח, בדקו את כתובת הבסיס, בחרו איך להתחבר ולחצו על Connect.
| מארח | כתובת בסיס | הערות |
|---|---|---|
| GitLab | https://gitlab.com או כתובת ה-GitLab שלכם | pull requests הם merge requests; ריצות CI הן pipelines |
| Bitbucket Cloud | https://bitbucket.org | מתחברים עם טוקן API של Atlassian וכתובת האימייל של Atlassian כשם משתמש, או עם OAuth |
| Bitbucket Data Center | https://bitbucket.example.com | גם Bitbucket Server. מאגרים הם PROJECT/repo; ה-CI הוא סטטוסי build; ל-Data Center אין issues |
| Azure DevOps | https://dev.azure.com/<organization> או https://tfs.example.com/<collection> | מאגרים הם project/repo; issues הם work items; ה-CI הוא builds של Azure Pipelines |
| Gitea | https://gitea.example.com | ה-CI הוא Gitea Actions או סטטוסי commit |
| Forgejo | https://codeberg.org או כתובת ה-Forgejo שלכם | כמו Gitea |
| אירוח עצמי אחר | כל כתובת | Detect שואל את השרת ובוחר GitLab, Bitbucket Data Center, Azure DevOps Server, Gitea או Forgejo |


עם טוקן גישה
הדביקו טוקן גישה אישי. הטופס מציג את ההרשאות שהטוקן צריך וקישור Create a token לעמוד הטוקנים של המארח:
| מארח | הרשאות הטוקן |
|---|---|
| GitLab | api (או read_api אם הסוכנים רק קוראים) |
| Bitbucket Cloud | read:repository, read:pullrequest, write:pullrequest, read:issue, write:issue, read:pipeline |
| Bitbucket Data Center | כתיבה למאגר (טוקן גישה HTTP) |
| Azure DevOps | Code (Read & write), Work Items (Read & write), Build (Read) |
| Gitea ו-Forgejo | repository, issue ו-user (קריאה וכתיבה) |
Ingot בודק את הטוקן בכך שהוא שואל את המארח מי אתם, ואז שומר את החשבון. טוקן שהמארח דוחה אף פעם לא מוצג בהודעת השגיאה.
עם OAuth
רשמו אפליקציית OAuth במארח עם כתובת ההפניה http://127.0.0.1:<any port>/callback (Ingot בוחר פורט פנוי בכל התחברות, כפי ש-RFC 8252 מתאר לאפליקציות שולחן עבודה). בחרו OAuth, הזינו את ה-client ID (ואת ה-client secret רק אם המארח יצר אפליקציה חסויה) ולחצו על Sign in with browser. עמוד ההסכמה של המארח נפתח בדפדפן; אחרי האישור המארח מחזיר את הדפדפן ל-Ingot והחשבון מחובר. Ingot משתמש ב-PKCE, כך שאפליקציות ציבוריות לא צריכות secret, והוא מחדש את הטוקן לפני שהוא פג.
Custom endpoints and scopes מאפשר לקבוע את כתובת ההרשאה, כתובת הטוקן וההרשאות כשהשרת שלכם משתמש בערכים אחרים. ברירת המחדל היא נקודות הקצה הסטנדרטיות של המארח, למשל /oauth/authorize ו-/oauth/token ב-GitLab עם ההרשאות api read_user, ו-Microsoft Entra ID עבור Azure DevOps.


איפה נשמרים החשבונות והטוקנים
החשבון (מארח, כתובת בסיס, משתמש, אופן ההתחברות) נשמר ב-~/.ingot/git-hosts.json, שגם ה-CLI של ingot קורא. הטוקנים אף פעם לא נשמרים שם: Ingot שומר אותם בקובץ המפתחות שלו, ~/.ingot/keystore.json, שרק המשתמש שלכם יכול לקרוא. Disconnect מוחק את שניהם.
עיון במאגר
בצד שמאל נמצאים החשבונות שלכם והמאגרים של החשבון שנבחר (הקלידו בשדה הסינון ולחצו Enter כדי לחפש במארח). כשה-remote origin של הפרויקט נמצא במארח מחובר, המאגר שלו נפתח לבד. הלשוניות מציגות:
| לשונית | מה היא מציגה |
|---|---|
| Pull requests | מספר, כותרת, ענף מקור → יעד, מחבר ועדכון אחרון. Open, Merged, Closed או All |
| Issues | מספר, כותרת, סוג, תוויות ומחבר (work items ב-Azure DevOps). Open, Closed או All |
| Branches | כל הענפים, עם סימון לענף ברירת המחדל ול-commit שלו |
| CI | ריצות אחרונות: pipelines של GitLab, Bitbucket Pipelines או סטטוסי build, builds של Azure Pipelines, Actions של Gitea ו-Forgejo או סטטוסי commit, עם המצב שלהן |
לחיצה על שורה פותחת אותה במארח. כפתור הדופק ליד חשבון בודק שהוא עדיין עובד (Test connection); כפתור התקע מנתק אותו.


ליד PRs פתוחים יש כפתור Follow: Ingot עוקב אחרי ה-CI והערות הסקירה של ה-PR ונותן לסוכן לתקן את מה שנכשל, עם אישור שלכם לכל דחיפה ולכל תשובה. ראו מעקב אחרי PR עד שהוא ירוק.
מה הסוכנים מקבלים
כשמארחי Git פעילים, הסוכנים מקבלים את שרת ה-MCP המובנה git-hosts: ערכת כלים אחת שעובדת אותו דבר בכל המארחים המחוברים. הוא מופיע ב-Rules, Commands & MCP Servers עם התווית Built-in, ושם אפשר לכבות כלים בודדים; אין לו פקודה או קובץ משלו, ולכן אין מה לערוך או להסיר. קריאות מבקשות אישור כמו כל כלי MCP עד שבוחרים Always Run.
| כלי | מה הוא עושה |
|---|---|
list_accounts | החשבונות המחוברים |
list_repos | מאגרים של חשבון, עם חיפוש אופציונלי |
list_branches | הענפים של מאגר |
list_pull_requests | pull requests (merge requests), לפי מצב |
get_pull_request | pull request אחד עם התיאור שלו |
create_pull_request | פותח pull request: כותרת, מקור, יעד (ענף ברירת המחדל אם לא צוין), תיאור, טיוטה |
list_issues | issues או work items, לפי מצב |
create_issue | יוצר issue או work item |
list_ci_runs | ריצות CI אחרונות, אופציונלית של ענף אחד |
כל הכלים מקבלים account ו-repo; שניהם אופציונליים כשה-origin של הפרויקט נמצא במארח מחובר. Read-only for agents בהגדרות משאיר בחוץ את create_pull_request ואת create_issue. שגיאות מהמארח מגיעות לסוכן בלי שום טוקן.
מקלדת
| פעולה | Find Action | קיצור (macOS / Windows ו-Linux) |
|---|---|---|
| הצגה או הסתרה של Git Hosts | Git Hosts: Show / Hide | ⌥⇧⌘\ / Ctrl+Alt+Shift+\ |
| הפעלה ופתיחה | Git Hosts: Open | |
| חיבור מארח | Git Hosts: Connect GitLab, Bitbucket, Azure DevOps, Gitea or Forgejo… | |
| רענון | Git Hosts: Refresh |
הגדרות
Settings › Tools › Git Hosts:
| הגדרה | ברירת מחדל | מה היא עושה |
|---|---|---|
Give agents the Git hosts tools (ingot.gitHosts.agentTools) | true | מציעה לסוכנים את שרת ה-MCP המובנה git-hosts כשמארחי Git פעילים |
Read-only for agents (ingot.gitHosts.readOnly) | false | משאירה בחוץ את הכלים שפותחים pull requests ויוצרים issues |
Settings › Features:
| הגדרה | ברירת מחדל | מה היא עושה |
|---|---|---|
Git Hosts (ingot.gitHosts.enabled) | false | מציגה את חלונית Git Hosts ונותנת לסוכנים את הכלים שלה; החשבונות נשארים מחוברים כשהיא כבויה |
Suggest features in chat (ingot.suggestions.enabled) | true | מציגה את כרטיסי ההצעה מעל תיבת הצ'אט, לכל התכונות האופציונליות |


מהטרמינל
ingot git עושה את אותו הדבר מטרמינל או מסקריפט, עם אותו קובץ חשבונות. הוא שומר טוקנים משלו ב-~/.ingot/cli/git-hosts-credentials.json (הרשאות 600), כך שמתחברים פעם אחת בכל מקום.
npx @ingotide/cli git hosts # supported hosts, token pages and scopes
npx @ingotide/cli git connect gitlab --token "$GITLAB_TOKEN" # or set INGOT_GIT_TOKEN
npx @ingotide/cli git connect https://git.example.com # detects the host and asks for a token
npx @ingotide/cli git connect gitlab --oauth --client-id <id> # OAuth with PKCE in your browser
npx @ingotide/cli git prs --state open # pull requests for this clone's origin
npx @ingotide/cli git pr create --title "Fix VAT" --source vat --draft
npx @ingotide/cli git ci --ref main # recent CI runs
npx @ingotide/cli git mcp --read-only # the git-hosts MCP server over stdio
ingot git mcp מגיש את אותם כלי git-hosts לכל לקוח MCP: הוסיפו { "git-hosts": { "command": "ingot", "args": ["git", "mcp"] } } ל-mcp.json שלו. כל הפקודות נמצאות בעמוד ה-CLI.
שאלות נפוצות
האם Ingot שולח את הקוד שלי למארח? לא. מארחי Git רק קוראים ל-API של המארח בשביל מאגרים, ענפים, pull requests, issues ו-CI, עם הטוקן שלכם, מהמחשב שלכם.
אפשר לחבר שני חשבונות באותו מארח? חשבון אחד לכל מארח וכתובת בסיס. חיבור מחדש (למשל עם OAuth במקום טוקן) מחליף את ההתחברות של החשבון הזה.
למה הסוכן לא רואה את הכלים? מארחי Git צריכים להיות פעילים, Give agents the Git hosts tools צריך להיות פעיל, ושרת git-hosts צריך להיות פעיל ב-Rules, Commands & MCP Servers.