> ## Documentation Index
> Fetch the complete documentation index at: https://exosphere-auto-translate-docs-20260623-1106.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# התחלה

> התקן את failproofai, הפעל מדיניויות, והתן לאג'נטים שלך לרוץ בצורה אמינה

## דרישות

* **Node.js** >= 20.9.0
* **Bun** >= 1.3.0 (אופציונלי - נדרש רק לבנייה מקוד)

***

## התקנה

<CodeGroup>
  ```bash npm theme={null}
  npm install -g failproofai
  ```

  ```bash bun theme={null}
  bun add -g failproofai
  ```
</CodeGroup>

***

## התחלה מהירה

<Steps>
  <Step title="הפעל מדיניויות">
    מדיניויות הן כללים שרצים לפני ואחרי כל קריאת כלי של אג'נט. הם תופסים פקודות הרסניות, דליפות סודיות, ודפוסי כשל אחרים לפני שהם גורמים נזק.

    ```bash theme={null}
    failproofai policies --install
    ```

    פעולה זו כותבת ערכי hook לתוך ממשקי ה-CLI של אג'נט המותקנים (`~/.claude/settings.json` של Claude Code, `~/.codex/hooks.json` של OpenAI Codex, `~/.copilot/hooks/failproofai.json` של GitHub Copilot CLI, `~/.cursor/hooks.json` של Cursor Agent, shim הפלאגין שנוצר של OpenCode ב-`~/.config/opencode/plugins/failproofai.mjs` בתוספת ערך רישום במערך `plugin` של `~/.config/opencode/opencode.json`, `~/.pi/agent/settings.json` של Pi, או `~/.gemini/settings.json` של Gemini CLI). כאשר יותר מאחד קיים תתבקע בחירה; העבר `--cli claude codex copilot cursor opencode pi gemini` (כל תת-קבוצה) כדי לדלג על ההנחיה.

    תמיכה GitHub Copilot CLI, Cursor Agent, OpenCode, Pi ו-Gemini CLI היא **beta** — התקן עם `--cli copilot`, `--cli cursor`, `--cli opencode`, `--cli pi`, או `--cli gemini`.

    ```bash theme={null}
    failproofai policies --install --scope project
    failproofai policies --install --cli codex --scope project
    failproofai policies --install --cli copilot --scope project
    failproofai policies --install --cli cursor --scope project
    failproofai policies --install --cli opencode --scope project
    failproofai policies --install --cli pi --scope project
    failproofai policies --install --cli gemini --scope project
    failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
    ```
  </Step>

  <Step title="אמת">
    ```bash theme={null}
    failproofai policies
    ```

    מציג כל מדיניות, האם היא מופעלת, וכל פרמטר מוגדר.
  </Step>

  <Step title="הפעל את לוח המחוונים">
    ```bash theme={null}
    failproofai
    ```

    פותח לוח מחוונים מקומי ב-`http://localhost:8020` שבו אתה יכול לעיין בהפעלות, לבדוק קריאות כלי, ולנהל מדיניויות.
  </Step>

  <Step title="הפעל את האג'נט שלך">
    הפעל את Claude Code כרגיל. אם האג'נט מנסה משהו סוכן, failproofai יחתוך אותו באופן אוטומטי. השאר אותו רץ ללא השגחה וסקור מה קרה בלוח המחוונים.
  </Step>
</Steps>

***

## כיצד מדיניויות פועלות

בכל פעם שאג'נט מפעיל כלי, Claude Code קורא ל-failproofai כתהליך משנה:

```text theme={null}
Claude Code  →  failproofai --hook PreToolUse  →  קורא JSON מ-stdin
                                                    מעריך מדיניויות
                                                    כותב החלטה ל-stdout
```

כל מדיניות מחזירה אחת משלוש החלטות:

* **allow** - האג'נט ממשיך כרגיל
* **deny** - הפעולה חסומה, לאג'נט מסביר למה
* **instruct** - הקשר נוסף מתווסף להנחיה של האג'נט

<Note>
  מדיניויות רצות בתהליך המקומי שלך. שום דבר לא נשלח לשירות מרחוק.
</Note>

***

## הגדר מדיניויות צוות עם מדיניויות מבוססות כנס

הדרך המהירה ביותר לכניסת סטנדרטים איכות על פני הצוות שלך היא כנס `.failproofai/policies/`. זרוק קובצי מדיניויות לתוך הספרייה הזו והם טעונים באופן אוטומטי — אין דגלים, אין שינויי תצורה, אין פקודות התקנה.

<Steps>
  <Step title="צור ספריית המדיניויות">
    ```bash theme={null}
    mkdir -p .failproofai/policies
    ```
  </Step>

  <Step title="הוסף קובצי מדיניויות">
    העתק את דוגמאות ההתחלה או כתוב שלך:

    ```bash theme={null}
    cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/
    ```

    או צור חדש:

    ```js theme={null}
    // .failproofai/policies/team-policies.mjs
    import { customPolicies, allow, deny, instruct } from "failproofai";

    customPolicies.add({
      name: "test-before-commit",
      match: { events: ["PreToolUse"] },
      fn: async (ctx) => {
        if (ctx.toolName !== "Bash") return allow();
        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
          return instruct("הפעל בדיקות לפני התחייבות.");
        }
        return allow();
      },
    });
    ```
  </Step>

  <Step title="התחייב ל-git">
    ```bash theme={null}
    git add .failproofai/policies/
    git commit -m "הוסף מדיניויות איכות צוות"
    ```

    כל חברה בצוות שיש לה failproofai מותקנת בוחרת את המדיניויות הללו באופן אוטומטי. אין צורך בהגדרה לכל מפתח.
  </Step>
</Steps>

<Tip>
  התחייב ל-`.failproofai/policies/` למאגר שלך כדי שכל הצוות ישתף את אותם סטנדרטים. כאשר הצוות שלך מגלה דפוסי כשל חדשים, הוסף מדיניויות ודחוף — כולם מקבלים את העדכון בשלהם הבא `git pull`. עם הזמן מדיניויות אלה הופכות לסטנדרט איכות חי שממשיך להשתפר.
</Tip>

***

## אחסון נתונים

כל התצורה והיומנים נשארים במכונה שלך:

| נתיב                                      | מה הוא מאחסן                    |
| ----------------------------------------- | ------------------------------- |
| `~/.failproofai/policies-config.json`     | תצורת מדיניות גלובלית           |
| `~/.failproofai/hook-activity.jsonl`      | היסטוריית ביצוע Hook            |
| `~/.failproofai/hook.log`                 | יומן ניפוי לשגיאות hook מותאמות |
| `.failproofai/policies-config.json`       | תצורה לכל פרויקט (מחויבת)       |
| `.failproofai/policies-config.local.json` | התעלמות אישית (gitignored)      |

***

## הסרה

```bash theme={null}
failproofai policies --uninstall
```

מסיר ערכי hook מ-`~/.claude/settings.json`. קובצי תצורה ב-`~/.failproofai/` נשמרים.

***

## שלבים הבאים

<CardGroup cols={2}>
  <Card title="תצורה" icon="gear" href="/he/configuration">
    הערכות וקובץ תצורה בפורמט
  </Card>

  <Card title="מדיניויות מובנות" icon="shield" href="/he/built-in-policies">
    כל 26 המדיניויות עם פרמטרים
  </Card>

  <Card title="מדיניויות מותאמות" icon="code" href="/he/custom-policies">
    כתוב מדיניויות שלך ב-JavaScript
  </Card>

  <Card title="צג אג'נט" icon="chart-line" href="/he/dashboard">
    עקוב אחר הפעלות וסקור פעילות מדיניויות
  </Card>
</CardGroup>