Skip to main content
Claw Lens requires Node.js 18 or later. Run node --version to check your version before proceeding.
1

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.
npx claw-lens-cli
Claw Lens ingests your agent session files into a local database and opens the dashboard automatically.
2

Open the dashboard

The dashboard opens at 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.
3

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

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.

​
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 page.