> ## Documentation Index
> Fetch the complete documentation index at: https://claw-lens.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Run Claw Lens in under a minute using npx or a global install, then open the dashboard at http://localhost:4242.

<Note>
  Claw Lens requires **Node.js 18 or later**. Run `node --version` to check your version before proceeding.
</Note>

<Steps>
  <Step title="Start Claw Lens">
    The fastest way to run Claw Lens is with `npx` — no install step required. If you prefer a persistent global command, install it once and run `claw-lens` from anywhere.

    <CodeGroup>
      ```bash npx (no install) theme={null}
      npx claw-lens-cli
      ```

      ```bash Global install theme={null}
      npm install -g claw-lens-cli
      claw-lens
      ```
    </CodeGroup>

    Claw Lens ingests your agent session files into a local database and opens the dashboard automatically.
  </Step>

  <Step title="Open the dashboard">
    The dashboard opens at [http://localhost:4242](http://localhost:4242) automatically when Claw Lens starts. If you passed `--no-open`, navigate there manually in your browser.

    The **Overview** page shows total cost, session counts, and active agent health at a glance.
  </Step>

  <Step title="Explore your sessions">
    Go to **Sessions** to browse every recorded agent run. Click any session to open the **Session Timeline** and step through every LLM turn and tool call in order.
  </Step>

  <Step title="Check the security audit">
    Open **Security Audit** to review any flagged events — sensitive data in prompts, credential exposure, dangerous shell commands, or prompt injection attempts.
  </Step>
</Steps>

## Configuration

Claw Lens works out of the box with zero configuration. To customize the port, suppress auto-open, or point to a different data directory, see the [CLI Reference](/reference/cli) page.