מדריך ה-CLI של ingot
כל הפקודות והאפשרויות של ingot, כלי שורת הפקודה שיוצר שלד, בודק, אורז ומפרסם תוספים לחנות של Ingot (החבילה @ingotide/cli, Node.js 22 ומעלה).
npm install -g @ingotide/cli # or: npx @ingotide/cli <command>
ingot help
ingot <command> --help
פקודות
| פקודה | מה היא עושה |
|---|---|
ingot init [folder] | יוצרת שלד לתוסף: ingot.json, README, CHANGELOG, LICENSE, .gitignore, קבצי התחלה ו-workflow של CI |
ingot add <kind> <name> | מוסיפה חוק, Habit, פקודה או שרת MCP: את הקובץ ואת הרשומה שלו ב-ingot.json |
ingot try <project> | מתקינה את התוסף בתיקייה .ingot/ של פרויקט כדי לבדוק אותו |
ingot validate | בודקת את ingot.json ואת כל קובץ שהוא מצביע עליו, כמו החנות |
ingot package | כותבת <publisher>.<name>-<version>.ingotx |
ingot login | בודקת טוקן לפרסום ושומרת אותו |
ingot logout | שוכחת את הטוקן השמור |
ingot whoami | מציגה את המפרסם ואת תוקף הטוקן שבשימוש |
ingot publish [file] | מעלה לחנות |
ingot unpublish [id] | מסירה גרסה או את כל התוסף |
ingot version [bump] | מציגה גרסאות, או מעלה את הגרסה ב-ingot.json |
ingot export | כותבת את .ingot/rules אל AGENTS.md, CLAUDE.md, .cursor/rules, .windsurf/rules והנחיות Copilot; --check ל-CI |
ingot rules test | מריצה את .ingot/tests/*.yaml מול החוקים שלך עם מודל זול ותקרת עלות קשיחה |
ingot rules prune | מציגה חוקים ישנים (לא בשימוש, globs מתים, נתיבים שנמחקו, חבילות שהוסרו); --apply מסירה אותם |
ingot review | סקירת סוכן לפני commit: השינויים המסומנים (ואם אין, כולם), במצב סקירה (--mode) או כ-Find issues (--find-issues), עם ממצאים, תיקונים ותקרת עלות קשיחה; יוצאת עם 1 על ממצאים חמורים |
ingot tab predict <file> | מציגה את טקסט הרפאים ואת העריכה הבאה ש-Tab היה מציע ב---line, עם מודל זול ותקרת עלות קשיחה |
ingot context files|attach|compose|rules|projects | מה שהצ׳אט של הסוכן מצרף: כל קובצי הפרויקט בסדר של בוחר ה-@, ההקשר שצ׳יפ שולח, הפרומפט שהודעה מוקלדת שולחת (צ׳יפים לפי סדר ההקלדה), הכללים של תפריט / ורשימת /projects/. לא נקרא אף מודל |
ingot learnings | הקשר משותף לפרויקט: מה שסוכנים וחברי צוות למדו על הפרויקט ב-.ingot/context. list, add, share, outdated, remove, מה שסוכן מקבל (prompt), check ל-CI ו-sync ל-AGENTS.md. לא נקרא אף מודל |
ingot image notes <image> | שואלת מודל ראייה על תמונה; הוא מצביע על חלקים בה עם הערות ממוספרות, והפקודה כותבת SVG מוער, עם תקרת עלות קשיחה |
ingot merge <yours> <base> <theirs> | מיזוג חכם, כמו במציג ההבדלים: שינויים בלי קונפליקט מוחלים, וקונפליקטים נשארים עם סימונים; יוצאת עם 1 כל עוד נשארו קונפליקטים |
ingot handoff send | שולחת משימה או תוכנית לסוכן ענן של Ingot על מאגר ה-GitHub של הפרויקט; list, status, cancel, followup ו-checkout עוקבות אחרי הריצות שלו |
ingot preview servers|devices|check | התצוגה המקדימה של האפליקציה מהטרמינל: שרתי פיתוח ודפי אינטרנט מקומיים כמו בתפריט הפורטים שלה, גדלי המכשירים, והאם פורט או כתובת עונים (--wait לסקריפטים). לא נקרא שום מודל |
ingot preview mobile, ingot preview qr | תצוגה מקדימה במובייל מהטרמינל: סימולטורים של iOS, אייפונים, אמולטורים וטלפונים של Android, פתיחת שרת פיתוח או אפליקציית Expo באחד מהם, חיבור Android ב-Wi-Fi וקוד QR של כתובת ה-LAN. לא נקרא שום מודל |
ingot usage | יחידות טוקנים שנשארו, שימוש לפי רמת מודל, דקות Zaprex; הפעלה או כיבוי של שימוש לפי דרישה עם תקרה; תקרות לחברי צוות |
ingot agents | מרכז הבקרה לסוכנים בטרמינל: הסוכנים של כל חלון Ingot במחשב הזה וריצות סוכני הענן שלך, לפי סטטוס; cancel עוצר ריצת ענן |
ingot automations | סוכנים שמופעלים על PR, תגובה, כשל CI, Slack, webhook או לוח זמנים ומחזיקים מטרה עד שהיא מושגת: list, validate, new, test בלי רשת, sync לענן, run ו-fires |
ingot acp | סוכני קוד פתוח (OpenCode, Goose, OpenHands) או כל סוכן Agent Client Protocol שתוסיף, מהטרמינל: רשימה, בדיקת החיבור, הרצת תור אחד והוספת סוכן משלך |
ingot arena | מצב Arena בטרמינל: שני מודלים מוסתרים עונים על אותה משימה תחת תקרת עלות קשיחה, אתם מצביעים ואז המודלים נחשפים; vote, leaderboard ו-votes קוראות וכותבות את .ingot/arena/votes.jsonl |
ingot extensions | הרחבות מחנות Ingot, כמו ה-Agent Command Center: רשימה עם מחיר ורמה, מידע, התקנה, הסרה, והפעלה או כיבוי של הצעות הפיצ'רים באפליקציה |
ingot panes | Session Panes: תכנון של עד 8 סשנים של סוכנים ב-.ingot/panes.json ש-Ingot יפתח זה לצד זה. list, add, remove, clear, layout, validate ל-CI ו-grid לתצוגה מקדימה של פריסה. לא נקרא אף מודל |
ingot layout | פריסת סוכן ממוקדת: מציג כל הגדרת פריסה עם הקובץ שממנו היא מגיעה, משנה או מאפס אחת בקובץ ההגדרות של הפרויקט, המשתמש או הגלובלי, ומציג את כולן. לא נקרא אף מודל |
ingot sandbox | Agent Sandbox: איזה ארגז חול של מערכת ההפעלה הסוכנים מקבלים במחשב הזה (Seatbelt, bubblewrap או שער האישורים ב-Windows), ורשימת ההיתרים של הפרויקט (פקודות, שרתים ותיקיות) ב-.ingot/policy.json. status, list, allow, remove ו-wrap להצגת שורת הפקודה בתוך ארגז החול. לא נקרא אף מודל |
ingot git | מארחי Git: חיבור GitLab, Bitbucket Cloud ו-Data Center, Azure DevOps, Gitea או Forgejo עם טוקן או OAuth, רשימת מאגרים, ענפים, pull requests, issues וריצות CI, פתיחת pull request או issue, ו-mcp מגיש את אותם כלים לסוכנים |
ingot mcp | שרתי MCP: רשימת השרתים ב-mcp.json, כניסה לשרתים מרוחקים עם OAuth, בדיקת בריאות (יציאה עם 1 כששרת נפל), רשימת כלים עם רמת הסיכון שלהם והרצת כלי |
ingot extensions search|install|inspect|sources | חיפוש ב-Marketplace: רשימה אחת מ-Ingot Store ומ-Open VSX (Microsoft Marketplace רק עם --microsoft-marketplace), התקנת .vsix לפי מזהה או קובץ לתיקיית ההרחבות של Ingot, ובדיקה של .vsix. בקיצור ingot ext |
ingot habits | הרגלים: תיקיית הידע לפי סוג .ingot/habits/ (bug.md, tests.md, …). init, add (מסווג או --type), classify, read, relevant, new-type (או new type <name>), list, show וה-playbooks לתרחישים (new playbook <name>). לא קורא למודל |
רוב הפקודות מקבלות --cwd <dir> כדי לעבוד על תיקייה אחרת, וגם --help.
init
ingot init [folder] --type <theme|rules|habits|mcp|rex-template> [options]
| אפשרות | ברירת מחדל | הערות |
|---|---|---|
--type | נשאלת | סוג התוסף |
--name | שם התיקייה | מילים באותיות קטנות מחוברות ב-- |
--publisher | נשאלת | מזהה המפרסם שלכם |
--display-name | לפי השם | השם שמוצג בחנות |
--description | לפי הסוג | שורה אחת לכרטיס בחנות |
--license | MIT | מזהה SPDX; נכתב קובץ LICENSE של MIT |
--ci | github | github (.github/workflows/ingot-publish.yml), gitlab (.gitlab-ci.yml) או none |
--force | כותבת לתיקייה שאינה ריקה | |
-y, --yes | לא שואלת אף פעם; משתמשת בברירות המחדל |
בלי --yes, ערכים חסרים נשאלים באופן אינטראקטיבי. ב-CI (בלי טרמינל, או כש-CI מוגדר) שום דבר לא נשאל.
add
ingot add rule <name> [--description <text>]
ingot add habit <id> [--title <text>] [--match <regex>] [--rule <text>]
ingot add command <name> [--description <text>]
ingot add mcp <id> --command <cmd> [--env NAME=description]... [-- <args>...]
ingot add mcp <id> --url https://...
ארגומנטים אחרי -- מועברים לפקודה של שרת ה-MCP, כך שאפשרויות כמו -y מגיעות אליה: ingot add mcp acme --command npx -- -y @acme/mcp.
try
ingot try <project-folder> [--cwd <extension-folder>]
מעתיקה את החבילה אל <project>/.ingot/extensions/<publisher>.<name>/, את החוקים אל .ingot/rules/, את הפקודות אל .ingot/commands/, ומוסיפה את שרתי ה-MCP ל-.ingot/mcp.json. הריצו אותה שוב אחרי כל שינוי.
validate ו-package
ingot validate
ingot package [--out <file>]
שתיהן מריצות את הבדיקות של החנות (שדות המניפסט, נתיבי קבצים, תוכן הקבצים, דפוסי Habits, ה-JSON של ערכות צבעים, מגבלות). package גם כותבת את ה-.ingotx ומדפיסה את הקבצים שלו ואת ה-SHA-256.
login, logout, whoami
ingot login [--token <token>] [--registry <url>]
ingot whoami
ingot logout
login בודקת את הטוקן מול החנות ושומרת אותו ב-~/.ingot/cli/credentials.json (הרשאות 600). הגדירו INGOT_CLI_HOME כדי לשמור אותו במקום אחר. ב-CI, דלגו על login והשתמשו ב-INGOT_PUBLISH_TOKEN.
publish
ingot publish [package.ingotx] [--token <token>] [--registry <url>] [--no-package]
בלי קובץ, היא אורזת קודם את התיקייה הנוכחית. --no-package מעלה את ה-.ingotx ש-ingot package כבר כתבה לגרסה הנוכחית (כך עושים ב-CI, כדי שהקובץ שעולה יהיה זה שנבנה ונשמר כ-artifact).
unpublish
ingot unpublish [publisher.name[@version]] [--version <x.y.z>] [--yes]
בלי מזהה היא משתמשת ב-ingot.json שבתיקייה. בלי גרסה היא מסירה את כל הגרסאות. היא מבקשת להקליד את השם לאישור; --yes חובה כשאי אפשר לשאול (CI).
version
ingot version # CLI version and the extension's version
ingot version patch # or minor, major, or an exact version like 2.0.0-beta.1
מעדכנת את version ב-ingot.json ומוסיפה כותרת ל-CHANGELOG.md. אחר כך עשו commit, תייגו ודחפו (git tag v1.2.3).
חוקי הפרויקט
export ו-rules עובדות על .ingot/rules של פרויקט, לא על תוסף. הריצו אותן בתיקיית הפרויקט או העבירו --cwd.
npx @ingotide/cli export --check # CI: נכשל כשקבצים מיוצאים לא מעודכנים
npx @ingotide/cli rules test --mock # CI: בדיקות חוקים עם מודל הדמה החינמי
npx @ingotide/cli rules prune # הרצה יבשה; הוסיפו --apply כדי לשנות קבצים
כל האפשרויות מופיעות בייצוא חוקים, בדיקות חוקים וניקוי חוקים ישנים.
תמונות
image notes שולחת תמונה למודל שקורא תמונות, מקבלת הערות ממוספרות (מסגרות, חצים, נעצים, טקסט) וכותבת SVG מוער ליד התמונה.
npx @ingotide/cli image notes screenshot.png --prompt "Is the header aligned?" # מודל ברירת המחדל, תקרה של $0.01
npx @ingotide/cli image notes screenshot.png --mock --json # CI: תשובת הדמה החינמית
כל האפשרויות מופיעות בהערות על תמונות.
סקירה לפני commit
review מריצה את סקירת הסוכן של ה-IDE על השינויים המסומנים (כל השינויים כששום דבר לא מסומן), ב-hook של git או ב-CI:
npx @ingotide/cli review --staged # hook של pre-commit: יוצאת עם 1 על ממצא חמור
npx @ingotide/cli review --apply # כותבת את התיקונים המוצעים לקבצים
npx @ingotide/cli review --mode both # חוקי הפרויקט יחד עם רשימות התעשייה
npx @ingotide/cli review --find-issues # חיפוש באגים מעמיק שקורא את הקבצים המלאים
npx @ingotide/cli review --mock --json # סוקר דמה חינמי ודטרמיניסטי לבדיקת pipelines
כל האפשרויות מופיעות בסקירת סוכן לפני commit.
Tab
tab predict שולחת את אותו prompt ש-Tab שולח בעורך (הקוד סביב הסמן ועוד כמה קבצים סמוכים) ומדפיסה את החיזוי. קבצים שתואמים ל-.ingot/ignore לא נקראים לעולם.
npx @ingotide/cli tab predict src/app.ts --line 12 # מודל ברירת המחדל, תקרה של $0.01
npx @ingotide/cli tab predict src/app.ts --mock # CI: מודל הדמה החינמי
כל האפשרויות מופיעות בהשלמה עם Tab.
Diff ו-merge
merge מריצה את המיזוג החכם של מציג ההבדלים על שלושה קבצים: כל שינוי שרק צד אחד עשה (או ששני הצדדים עשו באותה צורה) מוחל על הבסיס, וכל קונפליקט נשאר עם סימוני diff3, או נפתר עם --conflicts yours|theirs|both.
npx @ingotide/cli merge yours.ts base.ts theirs.ts # מדפיסה את התוצאה; יוצאת עם 1 כל עוד נשארו קונפליקטים
npx @ingotide/cli merge yours.ts base.ts theirs.ts -o yours.ts --json # כותבת אותה ומדפיסה {conflicts, merged, sameLine, chunks}
git config merge.ingot.driver "ingot merge %A %O %B --output %A" # כ-merge driver של git
--label-yours ו---label-theirs קובעים את השמות אחרי <<<<<<< ו->>>>>>> (ברירת המחדל: נתיבי הקבצים).
כששני הצדדים ערכו את אותה שורה אבל טוקנים שונים, השורה ממוזגת טוקן אחרי טוקן, כמו במציג (sameLine ב---json). --line-only ממזגת רק שורות שלמות, כמו git: כל שורה ששני הצדדים ערכו היא קונפליקט.
הקשר הצ׳אט
context מציגה מהטרמינל מה הצ׳אט של הסוכן מצרף. שום דבר לא נשלח למודל ושום דבר לא יוצא מהמחשב.
npx @ingotide/cli context files crt # src/cart.ts: הסינון הגמיש של בוחר ה-@
npx @ingotide/cli context attach src/cart.ts:1-2 docs @api-style # הבלוקים שהצ׳אט שולח
npx @ingotide/cli context rules # Project rules ואחריהם User rules
npx @ingotide/cli context compose "explain lines 20-21 of @src/cart.ts" # הפרומפט שהצ׳אט שולח, צ׳יפים לפי סדר ההקלדה
npx @ingotide/cli context files helper --project other-app # קובץ מפרויקט אחרון, נתיב מלא
כל האפשרויות מופיעות ב-גרירה, הדבקה ו-@ קבצים, ב-@opens, @pins, כללים ב-/ ו-/projects וב-צ׳יפים בתוך הטקסט בצ׳אט.
הקשר משותף לפרויקט
learnings עובד עם ההקשר המשותף לפרויקט ב-.ingot/context/, קובץ Markdown אחד לכל למידה. add מאשר למידה שכבר קיימת במקום להעתיק אותה, ומחליף כל מה שנראה כמו סוד ב-[redacted]. list --status stale מציג למידות שכל הנתיבים שלהן כבר לא קיימים. check יוצא עם 1 על שמות קבצים לא תקינים, נושאים או מצבים לא מוכרים וסודות, ומזהיר על למידות ישנות וכמעט-כפולות. sync כותב את הבלוק ב-AGENTS.md לסוכני קוד אחרים; sync --check יוצא עם 1 כשהוא לא מעודכן.
npx @ingotide/cli learnings # proposed first, stale flagged; --status, --topic, --json
npx @ingotide/cli learnings add "[test] Run e2e with npm run e2e (paths: e2e/)" --propose
npx @ingotide/cli learnings prompt "fix the users endpoint" --files src/api/users.ts # exactly what an agent gets
npx @ingotide/cli learnings outdated test-run-e2e-with-npm-run-e2e-k3f9 --reason "renamed to test:e2e"
npx @ingotide/cli learnings check && npx @ingotide/cli learnings sync --check # in CI
סוכני ענן
handoff מעבירה משימה לסוכן ענן של Ingot, שעובד על מאגר ה-GitHub ופותח pull request בטיוטה. היא צריכה אסימון גישה אישי (ingot_pat_…) ב---token או ב-INGOT_TOKEN:
ingot handoff send --prompt "Add CSV export to the reports page" --watch # עוקבת אחרי הריצה עד שה-PR נפתח
ingot handoff send --plan plan.md --dry-run # מציגה את התדריך בלי לשלוח
ingot handoff status <run> --json
ingot handoff checkout <run> # מביאה את ענף הריצה ועוברת אליו
כל האפשרויות מופיעות בהעברה לסוכן ענן.
תצוגה מקדימה של האפליקציה
preview מציג את מה שהלשונית תצוגה מקדימה של האפליקציה רואה: שרתי פיתוח מקומיים קודם עם הפריימוורק וכותרת הדף, ואחריהם דפי אינטרנט מקומיים אחרים (אף פעם לא הפורטים של Ingot או אפליקציות שולחן עבודה), וגדלי המכשירים. check אומר אם פורט או כתובת עונים ויוצא עם 1 אם לא, כך שסקריפטים יכולים לחכות לשרת פיתוח:
ingot preview servers --dev # רק שרתי פיתוח; --exclude <port>, --json
ingot preview devices # הגדלים וה-ids שמקבל --device
ingot preview check 5173 --wait 30 # מחכה עד 30 שניות ששרת הפיתוח יענה
ingot preview check localhost:3000/cart --device iphone-15-pro --json
כל האפשרויות נמצאות בתצוגה מקדימה של האפליקציה.
תצוגה מקדימה במובייל
preview mobile מציג את מה שפאנל Devices של התצוגה המקדימה במובייל רואה: סימולטורים של iOS שהופעלו, אייפונים ואייפדים מצומדים (xcrun devicectl), אמולטורים וטלפונים של Android (adb), שרת Metro או Expo שרץ, ומה חסר ואיך להתקין אותו. open שולח פורט או כתובת למכשיר לפי מזהה או שם, עם הכתובת שהמכשיר מגיע אליה: localhost בסימולטורים, 10.0.2.2 באמולטור Android וכתובת ה-LAN בטלפונים. --app פותח במקום זאת את אפליקציית React Native או Expo. preview qr מדפיס בטרמינל קוד QR של כתובת ה-LAN:
ingot preview mobile --json # devices by group, Metro, and missing tools
ingot preview mobile open "iPhone 15 Pro" 5173 # a device by id or name, a port or URL; --lan <ip>
ingot preview mobile open emulator-5554 --app # Expo Go, a development build or the installed app
ingot preview mobile connect 192.168.1.40:5555 # adb connect for Android over Wi-Fi
ingot preview qr 5173 --invert # QR code of the LAN address; --expo for Expo Go, --metro <port>
כל האפשרויות נמצאות בתצוגה מקדימה במובייל.
סוכנים
agents מדפיס את כל הסוכנים לפי סטטוס, כמו מרכז הבקרה לסוכנים ב-Ingot: הצ'אטים של כל חלון Ingot פתוח במחשב הזה, ועם טוקן גישה אישי (ingot_pat_…) ב---token או ב-INGOT_TOKEN גם ריצות סוכני הענן שלך:
ingot agents # כל הסוכנים לפי עמודה
ingot agents --status needs-you # אישורים, שאלות וריצות מושהות
ingot agents --local --json
ingot agents cancel <cloud-run-id>
כל האפשרויות מפורטות במרכז הבקרה לסוכנים.
שימוש ושימוש לפי דרישה
usage מציגה את יחידות הטוקנים של חשבון Ingot שלכם, שימוש לפי רמת מודל, דקות Zaprex ומצב השימוש לפי דרישה, ומשנה את השימוש לפי דרישה ואת התקרות של חברי הצוות. היא צריכה טוקן גישה אישי (ingot_pat_...) ב---token או ב-INGOT_TOKEN; השרת הוא --server, אחר כך INGOT_SERVER, אחר כך https://www.ingotide.com.
npx @ingotide/cli usage # units left, per tier, Zaprex, on-demand
npx @ingotide/cli usage on-demand on --cap 25 # on-demand with a $25 monthly cap; off turns it off
npx @ingotide/cli usage cap dev@example.com none # remove a team member's unit cap
כל האפשרויות בשימוש ושימוש לפי דרישה.
אוטומציות
automations עובדת עם האוטומציות בתיקייה .ingot/automations/. list, validate, new ו-test עובדות בלי רשת; sync, run ו-fires משתמשות בחשבון Ingot שלכם עם אותו טוקן ושרת כמו usage. המאגר הוא --repo, אחרת ה-remote origin של התיקייה.
npx @ingotide/cli automations validate # exits 1 when a file has errors
npx @ingotide/cli automations new "Fix CI" --on ci_failure --prompt "Fix the build" --goal "CI passes" --check "npm test"
npx @ingotide/cli automations test --webhook '{"title":"Deploy failed"}' # which automations start, and why not
npx @ingotide/cli automations sync --secrets # upload run: cloud files; print the hook secrets
סוכנים חיצוניים (ACP)
acp מריצה את אותם סוכנים חיצוניים כמו חלונית External Agents ב-IDE: המובנים, אלה שב-~/.ingot/acp.json ואלה שב-.ingot/acp.json של הפרויקט. הסוכן קורא וכותב קבצים רק בתוך --cwd; סוכנים מובנים משתמשים בספק שהוגדר בסוכן עצמו, וסוכן שתוסיף יכול לקבל את מפתח ה-API שלו ממשתנה ה-keyEnv שלו.
npx @ingotide/cli acp agents # built-in and custom agents, and how each starts
npx @ingotide/cli acp doctor goose --session # protocol version, sign-in methods, can it open a session
npx @ingotide/cli acp run opencode --prompt "Explain src/cart.ts" --deny # reply on stdout; plan and tools on stderr
npx @ingotide/cli acp run team-bot --file task.md --allow --json # one JSON event per line
npx @ingotide/cli acp add team-bot --command team-bot --args="--acp" --key-env TEAM_BOT_API_KEY [--global]
בלי --allow, --deny או --read-only, הפקודה run שואלת בטרמינל ומסרבת ב-CI וב-pipes. --timeout <s> מגביל את ההפעלה (ברירת מחדל 120 שניות). קודי יציאה: 0 הסתיים, 1 נכשל, 2 שימוש, 3 סורב, 4 נעצר.
Arena
arena מריצה קרבות של מצב Arena בטרמינל. run שולחת משימה אחת לשני מודלים שנבחרים באקראי מתוך --models (שלושה מודלים זולים כברירת מחדל) ומציגה את התשובות כסוכן A וסוכן B בלי לחשוף את המודלים. היא צריכה OPENROUTER_API_KEY ועוצרת לפני הקריאה כשהעלות במקרה הגרוע עוברת את --max-cost (ברירת מחדל $0.02, קוד יציאה 3). vote <id> <a|b|tie|bad> שומרת את ההצבעה וחושפת את המודלים; leaderboard ו-votes קוראות את אותו .ingot/arena/votes.jsonl שה-IDE כותב. --mock (או INGOT_ARENA_MOCK=1) נותנת תשובות קבועות בלי רשת, ל-CI.
npx @ingotide/cli arena run "Write a debounce helper in TypeScript" # two hidden models answer
npx @ingotide/cli arena run "Explain this function" --with src/cart.ts --vote a
npx @ingotide/cli arena vote arena-mhj3k2ab-0a1b a # a, b, tie or bad
npx @ingotide/cli arena leaderboard # Elo table from .ingot/arena/votes.jsonl
npx @ingotide/cli arena run "Say hi" --mock # canned answers, no key or network (CI)
Extensions
extensions מנהל את ההרחבות מחנות Ingot מהטרמינל. היום כולן חינמיות (מחיר 0, רמה free) ועוברות את אותה בדיקת גישה שהרחבה בתשלום הייתה עוברת. install ו-uninstall מקבלות את מזהה הרישום, את מזהה ההרחבה או את הקישור ingot://install/extension/<id> מהחנות, ועורכות את settings.json של Ingot (--dir, אחרת THEIA_CONFIG_DIR, אחרת ~/.ingot), כך שחלונות פתוחים קולטים את השינוי. הסרת ה-Agent Command Center מכבה אותו, מאפסת את ההגדרות שלו ומוחקת את קובצי הלוח ב-agent-board/. suggestions on|off משנה את הצע פיצ'רים בצ'אט; suggestions reset <id> מחזיר הצעה שסגרתם ב-×.
npx @ingotide/cli extensions list # id, price, tier, installed (--json for scripts)
npx @ingotide/cli extensions info agent-command-center
npx @ingotide/cli extensions install agent-command-center
npx @ingotide/cli extensions uninstall agent-command-center
npx @ingotide/cli extensions suggestions off # on | off | reset <id>
חלוניות סשנים
panes עורך את .ingot/panes.json, הסשנים ש-Session Panes פותח זה לצד זה כשלוחצים Start ב-Ingot. הוא אף פעם לא קורא למודל ולא מפעיל סוכן. add מקבל פרומפט אופציונלי ו---title, --model, --mode agent|ask|plan|debug, --tab chat|files|changes|terminal, --worktree ו---id, ומסרב לחלונית תשיעית. remove מקבל מספר או מזהה של חלונית. validate יוצא עם 1 כשיש בקובץ שגיאות (JSON לא תקין, יותר מ-8 חלוניות, מזהים לא תקינים או כפולים, מצבים או לשוניות לא מוכרים); מפתחות לא מוכרים ומזהים חסרים הם רק אזהרות. עריכה אף פעם לא כותבת מחדש קובץ עם שגיאות.
npx @ingotide/cli panes # the panes with a layout drawing; --json
npx @ingotide/cli panes add "Write tests for the cart" --tab changes --worktree
npx @ingotide/cli panes layout rows # grid, columns or rows
npx @ingotide/cli panes validate # in CI
npx @ingotide/cli panes grid 5 --layout columns # how 5 panes are laid out, no file needed
פריסת הסוכן
layout קורא וכותב את שבע ההגדרות ingot.agentLayout.* של פריסת הסוכן הממוקדת בקובצי ההגדרות הרגילים, והאחרון גובר: ~/.ingot/ingot.settings.json (--global), ~/.ingot/settings.json (--user) וקובץ .ingot/settings.json של הפרויקט (--project, ברירת המחדל של set ו-reset). הגדרות מקבלות את השם הקצר (review) או את המפתח המלא (ingot.agentLayout.review); מתגים מקבלים true/false או on/off. set ו-reset שומרים על ההערות והעיצוב של הקובץ, ואף פעם לא כותבים מחדש קובץ שאינו JSON תקין (יציאה עם 1). Ingot מחיל את השינויים מיד. הוא אף פעם לא קורא למודל.
npx @ingotide/cli layout # each setting, its value and its source file; --json
npx @ingotide/cli layout set review editor # Review opens the Agent Review editor in this project
npx @ingotide/cli layout set enabled off --user # the classic chat panel for you
npx @ingotide/cli layout reset review # back to the user, global or default value
npx @ingotide/cli layout list --json # every setting with its values, default and description
ארגז החול של הסוכן
sandbox מציג את ארגז החול של מערכת ההפעלה שארגז החול של הסוכן נותן לפקודות של סוכנים במחשב הזה, ועורך את רשימת ההיתרים של הפרויקט ב-.ingot/policy.json. הוא אף פעם לא קורא למודל ולא מריץ סוכן. status (ברירת המחדל) אומר אם ארגז החול עובד כאן, וב-Linux בלי bubblewrap גם את הפקודה שמתקינה אותו; --platform darwin|linux|win32 מראה במה מערכת אחרת הייתה משתמשת. allow ו-remove מקבלים command, host או path וערך: פקודות נכנסות ל-commands.allow, שרתים ל-network.allow ותיקיות ל-sandbox.allowWrite. הם לא כותבים מחדש קובץ עם הערות או עם שגיאת JSON (חלונית Agent Sandbox שומרת על ההערות). wrap מדפיס את שורת הפקודה ש-Ingot מריץ, עם --network allow|deny.
npx @ingotide/cli sandbox # this machine's sandbox and the project's settings; --json
npx @ingotide/cli sandbox status --platform linux # what Ingot would use on Linux (darwin, linux, win32)
npx @ingotide/cli sandbox list # the allow-list; --json
npx @ingotide/cli sandbox allow command "npm run lint" # also: host <host>, path <folder>
npx @ingotide/cli sandbox remove host registry.npmjs.org
npx @ingotide/cli sandbox wrap "npm test" --platform linux --network deny
מארחי Git
git מחבר את המארחים שמארחי Git תומך בהם ועובד איתם מטרמינל או מסקריפט. connect מקבל gitlab, bitbucket-cloud, bitbucket-dc, azure-devops, gitea, forgejo, generic או כתובת (שמזוהה), עם --url לשרתים באירוח עצמי, ואז --token (אחרת INGOT_GIT_TOKEN, אחרת הוא שואל) או --oauth --client-id <id>. טוקני API של Bitbucket Cloud צריכים גם --user <האימייל של Atlassian>. פקודות המאגר משתמשות ב-origin של התיקייה הנוכחית כשהוא במארח מחובר, אחרת ב---repo owner/name וב---account. החשבונות משותפים עם אפליקציית Ingot ב-~/.ingot/git-hosts.json; ה-CLI שומר את הטוקנים שלו ב-~/.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, then 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 # this clone's origin; --repo and --account otherwise
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 on stdio
git mcp מגיש את כלי git-hosts (חשבונות, מאגרים, ענפים, pull requests, issues, CI, ויצירת pull requests ו-issues חוץ מאשר עם --read-only) לכל לקוח MCP דרך stdio: { "git-hosts": { "command": "ingot", "args": ["git", "mcp"] } }.
שרתי MCP
mcp עובד עם שרתי ה-MCP שב-~/.ingot/mcp.json וב-.ingot/mcp.json של הפרויקט, אותם קבצים ש-Ingot קורא (שרת של הפרויקט גובר על שרת גלובלי באותו שם). שרתים מרוחקים משתמשים ב-Streamable HTTP (MCP 2025-11-25) ונכנסים עם login: תהליך ה-OAuth של Ingot עם גילוי, רישום לקוח דינמי (או --client-id, --client-secret, --scopes, אחרת ה-auth של השרת ב-mcp.json), PKCE והפניה חזרה ל-127.0.0.1. שרתים מקומיים רצים ב-stdio. check מתחבר, מונה את הכלים ושולח פינג (--count, עד 20) ומדפיס Healthy, Slow, Degraded, Down או Sign-in required; הוא יוצא עם 1 כששרת נפל, פגום או צריך כניסה, כך שהוא מתאים ל-CI. call מריץ כלי אחד עם --args (אובייקט JSON); כלים שהשרת מסמן כהרסניים צריכים --yes. ערכי ${keychain} ב-mcp.json נלקחים ממשתנה הסביבה באותו שם, ו-CLIENT_SECRET ממחזיק המפתחות מ-INGOT_MCP_CLIENT_SECRET. הטוקנים נשמרים ב-~/.ingot/cli/mcp-credentials.json (הרשאות 600), בנפרד מאלה של Ingot, ולעולם לא מודפסים. ראו MCP מרוחק, OAuth ובריאות.
npx @ingotide/cli mcp list # servers, transport, signed in or not; --json
npx @ingotide/cli mcp login linear # OAuth with PKCE in your browser
npx @ingotide/cli mcp check --count 3 # health of every server; exit 1 if one is down
npx @ingotide/cli mcp tools linear # tools with read-only / write / destructive
npx @ingotide/cli mcp call linear list_issues --args '{"state":"open"}'
npx @ingotide/cli mcp call tracker delete_issue --args '{"id":"ENG-2"}' --yes
npx @ingotide/cli mcp logout linear
חיפוש ב-Marketplace
extensions (בקיצור ext) מריץ את החיפוש ב-Marketplace בטרמינל. search שואל את Ingot Store ואת Open VSX במקביל ומדפיס רשימה אחת, בלי כפילויות לפי מזהה, עם המקורות שבהם נמצאה כל תוצאה; מקור שנכשל מדווח והשאר עדיין מוצגים. --source ingot,open-vsx בוחר מקורות; --limit (עד 50) ו---json אופציונליים. Microsoft Marketplace נשאל רק עם --microsoft-marketplace, כי התנאים של Microsoft מתירים את ההרחבות שלו רק במוצרים של Microsoft; ה-CLI מדפיס את ההערה הזו כשמשתמשים בו. install מקבל מזהה (מוריד את ה-.vsix מהמקור הראשון שיש בו, --source כדי לבחור) או .vsix מקומי, בודק שה-extension/package.json שלו תואם ומעתיק אותו לתיקיית ההרחבות של Ingot (--dir, אחרת INGOT_EXTENSIONS_DIR, אחרת $THEIA_CONFIG_DIR/extensions, אחרת ~/.ingot/extensions); Ingot מתקין אותו בעלייה הבאה. קובץ קיים נשמר אלא אם מוסיפים --force. inspect מדפיס מזהה, גרסה ו-טווח ה-engine של .vsix בלי להתקין. קודי יציאה: 0, 1 כשלא נמצא כלום או שבדיקה נכשלה, 2 לשגיאות שימוש.
ה-Chrome guard פועל גם כאן: הרחבות שהיו מחליפות את מסגרת החלון של Ingot מסומנות blocked: בחיפוש ו-install לא שומר אותן אף פעם (קוד יציאה 1); הרחבה שרק משנה ברירות מחדל של המסגרת נשמרת עם אזהרה, ו-inspect מדפיס Shell guard: ok, blocked או warning. inspect מריץ גם את מגן ההרחבות ש-Ingot מריץ לפני שהוא מפעיל הרחבה, עם הרשימות המובנות שלו: Extension guard: ok, או not started in Ingot עם הסיבה והחלופה ב-Ingot, כך שמי שמפרסם הרחבה (למשל חבילת שפה ל-COBOL) יכול לבדוק .vsix לפני הפרסום.
npx @ingotide/cli extensions search prettier # Ingot Store + Open VSX, one list
npx @ingotide/cli extensions search prettier --microsoft-marketplace --json
npx @ingotide/cli extensions install rust-lang.rust-analyzer # the .vsix into Ingot's extensions folder
npx @ingotide/cli extensions install ./my-tool-1.0.0.vsix --force # a local file, replacing an older copy
npx @ingotide/cli extensions inspect ./my-tool-1.0.0.vsix # id, version and engine, nothing installed
npx @ingotide/cli extensions sources # each source, its URL and whether it is on
הרגלים
habits עובד על הרגלים, תיקיית הידע לפי סוג .ingot/habits/: קובץ Markdown אחד לכל סוג תיקון עם ידע מתמשך, תבליט אחד לכל רשומה. init יוצר את קובצי ברירת המחדל שחסרים ואף פעם לא דורס. add מסווג את הידע כמו ה-IDE (שם הסוג 2 נקודות, כל keyword נקודה אחת, general כששום דבר לא מתאים) או מקבל --type, יוצר את הקובץ אם הוא חסר ומדלג על רשומה שכבר קיימת. relevant מדפיס אילו קובצי סוגים הסוכן קורא למשימה ואת הטקסט המדויק שהוא מקבל. new <type> <name> כותב את אותם קבצים ש-Ingot כותב: new type i18n הוא קובץ סוג חדש (כמו new-type), new playbook <name> הוא playbook (--when ו---step); new <name> בלבד הוא playbook, כמו קודם. playbooks לתרחישים (קבצים עם when/steps) שומרים על show, new, validate, match, prompt ו-remove. הוא אף פעם לא קורא למודל.
npx @ingotide/cli habits init # bug.md, defect.md, … general.md
npx @ingotide/cli habits add "Always add a regression test before fixing a crash" # → bug.md
npx @ingotide/cli habits classify "Never log access tokens" # → security.md, and why
npx @ingotide/cli habits relevant "the checkout crashes on an empty cart"
npx @ingotide/cli habits new-type i18n --keyword locale # your own type file
npx @ingotide/cli habits new type i18n --keyword locale # the same, as new <type> <name>
npx @ingotide/cli habits new playbook Release --when "Shipping a version" --step "Tag it"
npx @ingotide/cli habits show Release # a playbook's trigger and steps
npx @ingotide/cli habits types --json
טוקנים ו-registry
הטוקן נלקח לפי הסדר מ: --token, משתנה הסביבה INGOT_PUBLISH_TOKEN, ואז הטוקן ש-ingot login שמרה עבור אותו registry.
ה-registry הוא --registry, אחריו INGOT_REGISTRY, ואחריו https://www.ingotide.com. registry חייב להשתמש ב-https://; http:// מותר רק ל-localhost (לבדיקה מול פורטל מקומי).
| משתנה | שימוש |
|---|---|
INGOT_PUBLISH_TOKEN | הטוקן לפרסום (CI) |
INGOT_REGISTRY | חנות אחרת, למשל http://localhost:3000 |
INGOT_CLI_HOME | איפה login שומרת את פרטי הגישה (ברירת מחדל ~/.ingot/cli) |
קודי יציאה ושגיאות
| קוד | משמעות |
|---|---|
0 | הצלחה |
1 | הפקודה נכשלה (שגיאות בדיקה, החנות דחתה את ההעלאה, שגיאת רשת), או ש-merge השאירה סימוני קונפליקט |
2 | שימוש שגוי (פקודה או אפשרות לא מוכרת, ארגומנט חסר) |
3 | rules test דילגה על בדיקה, או ש-review, tab predict או image notes לא קראו למודל, בגלל תקרת העלות; או שריצת סוכן הענן ש-handoff --watch עקבה אחריה לא הצליחה |
כשהחנות דוחה בקשה, ה-CLI מדפיס את קוד השגיאה ומה לעשות:
| שגיאה | מה לעשות |
|---|---|
invalid_token | הטוקן לא מוכר או בוטל: צרו טוקן חדש והריצו ingot login שוב |
token_expired | צרו טוקן חדש |
publisher_mismatch | publisher ב-ingot.json חייב להיות המזהה שלכם |
version_exists, version_not_newer | ingot version patch, ואז פרסמו |
invalid_manifest, invalid_contents | תקנו את השדות או הקבצים שברשימה (ingot validate מציגה את אותה רשימה) |
package_too_large | הסירו מ-files קבצים שאתם לא צריכים |
rate_limited | יותר מ-30 העלאות בשעה: חכו ונסו שוב |
publishing_unavailable | החנות לא יכולה לקבל העלאות כרגע |