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:

Script Tag

Fastest setup — one snippet

React

Hooks and context provider

Next.js

App Router and Pages Router

Vue

Composition API plugin

Nuxt

Auto-imported composables

SvelteKit

Stores and lifecycle hooks

Astro

Islands and SSR support

Angular

Injectable service

Node.js

Server-side tracking
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

How It Works

Understand how Outlit collects, resolves, and connects customer data

Customer Context Graph

Learn about the unified data model behind Outlit

CLI Commands

Full reference for querying customer data

Browser SDKs

Deep dive into browser integration options