Skip to main content

What is Outlit?

Outlit is a customer context layer that unifies website visits, product usage, and billing events into a single queryable graph. You install it with the CLI, add a lightweight tracker to your site, and immediately start querying customer data from the terminal or through AI agents.

Step 1: Install the CLI

npm install -g @outlit/cli

Step 2: Authenticate

If you already have an account:
outlit auth login
New to Outlit? Sign up directly from the terminal:
outlit auth signup
On macOS/Linux, the CLI stores your API key at ~/.config/outlit/credentials.json with 0600 permissions. You can also pass a key directly with --key or set the OUTLIT_API_KEY environment variable.

Step 3: Connect a Data Source

The browser SDK is the most common first integration — it captures website visits, form submissions, and engagement automatically. Choose your framework to get started: Connect external data sources like Stripe, PostHog, Slack, Gmail, and more from your integrations dashboard.
Outlit uses cookies to track visitors across pages. If you need GDPR compliance, show a consent banner before loading the tracker. See consent management →

Step 4: Query Your Data

Once the tracker is live and you have some traffic, use the CLI to explore:
# List your customers
outlit customers list

# See a customer's full timeline
outlit customers timeline acme.com

# Search with natural language
outlit search "who signed up this week"

# Run SQL directly
outlit sql "SELECT domain, billing_status, mrr_cents FROM customers ORDER BY mrr_cents DESC LIMIT 10"
Set up AI agents to query customer context directly from Cursor, Claude Code, or VS Code:
outlit setup --yes
This auto-detects installed agents and configures MCP access. See AI Agent Setup →

What happens automatically?

Once the browser SDK is installed, Outlit captures without any additional code:
WhatHow
PageviewsEvery page navigation, with URL, title, and referrer
Form submissionsField values with automatic sensitive-field sanitization
IdentityAuto-identifies visitors when forms contain an email field
Engagement timeActive time on each page (not just tab-open time)
AttributionUTM parameters, referrer, and landing page on first visit
Company enrichmentIP-based company identification for B2B visitor intelligence

Next Steps