> ## 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.

# Quickstart

> Capture an agent session, find a failure, and start preventing it.

This quickstart gets one machine reporting sessions, runs an audit, and deploys a policy. Use the skill to set Failproof up, or follow the manual steps. You need Node.js 20.9 or later.

<Tabs>
  <Tab title="Use the skill">
    <Steps>
      <Step title="Install the Failproof AI skills">
        ```bash theme={null}
        npx skills add FailproofAI/skills
        ```
      </Step>

      <Step title="Ask your agent to set everything up">
        ```text theme={null}
        Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives.
        ```

        Your agent inspects the project, chooses the relevant integration, performs the setup, and verifies it. See the [FailproofAI skills repository](https://github.com/FailproofAI/skills) for individual skills and advanced installation options.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Manual setup">
    ## Before you start

    1. Open the [Failproof AI dashboard](https://app.befailproof.ai) and create an account or sign in with your work email.
    2. Go to **Administration → Keys** and create a key with `events:add` and `policies:pull`.
    3. Copy the one-time secret and store it on the target machine:

    ```bash theme={null}
    export FAILPROOFAI_KEY="<one-time-secret>"
    ```

    ## Install

    <Steps>
      <Step title="Install and connect Failproof AI">
        ```bash theme={null}
        npm install -g failproofai
        failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY"
        ```

        Session transcripts are sent by default. Add `--no-transcripts` to report hook activity and policy decisions without transcript content.

        If this machine already has agent history, preview and import the last seven days, then wait for delivery to finish. Skip this step on a new machine.

        ```bash theme={null}
        failproofai backfill --since 7d --dry-run
        failproofai backfill --since 7d
        failproofai flush --wait
        ```

        Open **Sessions** in Failproof AI and select an imported session.
      </Step>

      <Step title="Install agent hooks and policies">
        This attaches Failproof AI to your agent CLI and installs the built-in policies. Use them to see local policy decisions and try enforcement before Failproof AI audits your sessions and writes policies for your agents.

        Let the installer detect your agent CLI, or name one explicitly.

        ```bash theme={null}
        failproofai policies --install --cli claude --scope user
        ```
      </Step>

      <Step title="Audit the behavior">
        Follow [Run your first failure check](/start/first-audit). Use a concrete goal such as “find sessions where the agent retried a failing tool without changing its approach.”
      </Step>

      <Step title="Prevent the failure">
        Follow [Prevent your first failure with a policy](/start/first-policy). Start in observe mode, inspect matches, then enforce the reviewed version.
      </Step>
    </Steps>

    <Check>
      Run `failproofai config --status`. A healthy setup reports the cloud connection, daemon state, and whether enforcement is paused.
    </Check>
  </Tab>
</Tabs>