> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/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 Code של `~/.claude/settings.json`, OpenAI Codex של `~/.codex/hooks.json`, GitHub Copilot CLI של `~/.copilot/hooks/failproofai.json`, Cursor Agent של `~/.cursor/hooks.json`, OpenCode של plugin shim שנוצר ב-`~/.config/opencode/plugins/failproofai.mjs` בתוספת ערך רישום במערך `plugin` של `~/.config/opencode/opencode.json`, Pi של `~/.pi/agent/settings.json`, או Hermes של `~/.hermes/config.yaml`). כאשר יותר מאחד קיים תתבקע לבחור; העבר `--cli claude codex copilot cursor opencode pi hermes` (כל קבוצה משנית) כדי לדלג על ההודעה.

    תמיכה ב-GitHub Copilot CLI, Cursor Agent, OpenCode ו-Pi היא **בטא** — התקן עם `--cli copilot`, `--cli cursor`, `--cli opencode`, או `--cli pi`. Hermes (hermes-agent, שער Slack/Telegram) מותקן בטווח משתמש עם `--cli hermes` והוא **גם** מקור ביקורת לא מקוון.

    ```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 hermes --scope user
    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("הרץ בדיקות לפני ביצוע commit.");
        }
        return allow();
      },
    });
    ```
  </Step>

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

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

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

***

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

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

| נתיב                                      | מה זה שומר                                |
| ----------------------------------------- | ----------------------------------------- |
| `~/.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>