Getting Started

This guide walks you through installing OpenLatch, authenticating, and running your first protected AI agent session.

Step 1: Install

Run the one-line installer:

npx openlatch

The installer will:

1. Download the OpenLatch client
2. Detect your installed AI coding agents
3. Configure tool call hooks automatically

Step 2: Authenticate

OpenLatch uses your GitHub account for authentication:

openlatch auth

This opens a browser window for GitHub OAuth. Once authenticated, the client is linked to your OpenLatch account.

Step 3: Start a Protected Session

Launch your AI coding agent as usual. OpenLatch hooks activate automatically:

# Example with Claude Code
claude

# OpenLatch is now monitoring tool calls in the background

Step 4: View Your Dashboard

Open the OpenLatch dashboard to see events from your session:

https://app.openlatch.ai

The dashboard shows:

• A timeline of intercepted tool calls
• Threat verdicts (allowed, blocked, flagged)
• Details about each action the agent attempted

What Happens Next

OpenLatch runs silently in the background. You’ll only notice it when a threat is detected and blocked. The agent receives a clear error message explaining why the action was stopped.

For a deeper understanding of the detection pipeline, see How It Works.