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

מארחי 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 Hosts ב-Ingot: חשבון GitLab מחובר, המאגר של הפרויקט וה-merge requests הפתוחים שלו עם ענפים, מחברים ותאריכיםחלונית Git Hosts ב-Ingot: חשבון GitLab מחובר, המאגר של הפרויקט וה-merge requests הפתוחים שלו עם ענפים, מחברים ותאריכים
חלונית Git Hosts ב-Ingot: חשבון GitLab מחובר, המאגר של הפרויקט וה-merge requests הפתוחים שלו עם ענפים, מחברים ותאריכים

הפעלה

את מארחי 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.
כרטיס ההצעה של Git Hosts מעל תיבת הצ'אט של Ingot, עם Enable Git Hosts וכפתור סגירהכרטיס ההצעה של Git Hosts מעל תיבת הצ'אט של Ingot, עם Enable Git Hosts וכפתור סגירה
כרטיס ההצעה של Git Hosts מעל תיבת הצ'אט של Ingot, עם Enable Git Hosts וכפתור סגירה
הכפתור Git Hosts בשורת המצב של Ingot, כשחלונית Git Hosts פתוחההכפתור Git Hosts בשורת המצב של Ingot, כשחלונית Git Hosts פתוחה
הכפתור Git Hosts בשורת המצב של Ingot, כשחלונית Git Hosts פתוחה
הגדרות Ingot, עמוד Features: ‏Suggest features in chat,‏ Session Panes והמתג של Git Hostsהגדרות Ingot, עמוד Features: ‏Suggest features in chat,‏ Session Panes והמתג של Git Hosts
הגדרות Ingot, עמוד Features: ‏Suggest features in chat,‏ Session Panes והמתג של Git Hosts

חיבור מארח

לחצו על Connect… בחלונית (או הריצו Git Hosts: Connect GitLab, Bitbucket, Azure DevOps, Gitea or Forgejo… מ-Find Action). בחרו מארח, בדקו את כתובת הבסיס, בחרו איך להתחבר ולחצו על Connect.

מארחכתובת בסיסהערות
GitLabhttps://gitlab.com או כתובת ה-GitLab שלכם‏pull requests הם merge requests; ריצות CI הן pipelines
Bitbucket Cloudhttps://bitbucket.orgמתחברים עם טוקן API של Atlassian וכתובת האימייל של Atlassian כשם משתמש, או עם OAuth
Bitbucket Data Centerhttps://bitbucket.example.comגם Bitbucket Server. מאגרים הם PROJECT/repo; ה-CI הוא סטטוסי build; ל-Data Center אין issues
Azure DevOpshttps://dev.azure.com/<organization> או https://tfs.example.com/<collection>מאגרים הם project/repo; ‏issues הם work items; ה-CI הוא builds של Azure Pipelines
Giteahttps://gitea.example.comה-CI הוא Gitea Actions או סטטוסי commit
Forgejohttps://codeberg.org או כתובת ה-Forgejo שלכםכמו Gitea
אירוח עצמי אחרכל כתובתDetect שואל את השרת ובוחר GitLab,‏ Bitbucket Data Center,‏ Azure DevOps Server,‏ Gitea או Forgejo
טופס Connect של Git Hosts: בורר מארחים עם GitLab,‏ Bitbucket Cloud ו-Data Center,‏ Azure DevOps,‏ Gitea,‏ Forgejo ו-Other self-hosted, כתובת בסיס, טוקן גישה ושםטופס Connect של Git Hosts: בורר מארחים עם GitLab,‏ Bitbucket Cloud ו-Data Center,‏ Azure DevOps,‏ Gitea,‏ Forgejo ו-Other self-hosted, כתובת בסיס, טוקן גישה ושם
טופס Connect של Git Hosts: בורר מארחים עם GitLab,‏ Bitbucket Cloud ו-Data Center,‏ Azure DevOps,‏ Gitea,‏ Forgejo ו-Other self-hosted, כתובת בסיס, טוקן גישה ושם

עם טוקן גישה

הדביקו טוקן גישה אישי. הטופס מציג את ההרשאות שהטוקן צריך וקישור Create a token לעמוד הטוקנים של המארח:

מארחהרשאות הטוקן
GitLabapi (או read_api אם הסוכנים רק קוראים)
Bitbucket Cloudread: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.

טופס Connect של Git Hosts במצב OAuth: ‏client ID,‏ client secret אופציונלי וכתובת ההפניה שצריך לרשום במארחטופס Connect של Git Hosts במצב OAuth: ‏client ID,‏ client secret אופציונלי וכתובת ההפניה שצריך לרשום במארח
טופס Connect של Git Hosts במצב OAuth: ‏client ID,‏ client secret אופציונלי וכתובת ההפניה שצריך לרשום במארח

איפה נשמרים החשבונות והטוקנים

החשבון (מארח, כתובת בסיס, משתמש, אופן ההתחברות) נשמר ב-~/.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); כפתור התקע מנתק אותו.

לשונית CI בחלונית Git Hosts: ‏pipeline של merge request שנכשל, pipeline של push שהצליח ואחד שרץ, עם ענפים ו-commitsלשונית CI בחלונית Git Hosts: ‏pipeline של merge request שנכשל, pipeline של push שהצליח ואחד שרץ, עם ענפים ו-commits
לשונית CI בחלונית Git Hosts: ‏pipeline של merge request שנכשל, pipeline של push שהצליח ואחד שרץ, עם ענפים ו-commits

ליד 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 HostsGit 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, ‏Tools › Git Hosts: ‏Give agents the Git hosts tools,‏ Read-only for agents ו-Open Git Hostsהגדרות Ingot, ‏Tools › Git Hosts: ‏Give agents the Git hosts tools,‏ Read-only for agents ו-Open Git Hosts
הגדרות Ingot, ‏Tools › Git Hosts: ‏Give agents the Git hosts tools,‏ Read-only for agents ו-Open Git Hosts

מהטרמינל

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.