Pi Agents

@outlit/pi registers Outlit customer intelligence tools inside Pi. Use it when you want a Pi agent to query complete customer profiles, timelines, facts, sources, and customer-context search results through Outlit’s public tool gateway.

Install

pi install npm:@outlit/pi

Set an Outlit API key before starting Pi:

export OUTLIT_API_KEY=ok_your_api_key
pi

Default Tools

The default Pi extension exposes the customer intelligence tools that are safe for most agents:

Tool	What it does
`outlit_list_customers`	Browse customers by billing status, activity, revenue, traits, or name
`outlit_list_users`	Browse contacts by journey stage, activity, customer, traits, email, or name
`outlit_get_customer`	Retrieve one complete customer profile
`outlit_get_timeline`	Retrieve customer activity across product, billing, support, and conversation channels
`outlit_list_facts`	List structured facts with status, source type, date, and provenance filters
`outlit_get_fact`	Retrieve one exact fact
`outlit_get_source`	Retrieve one exact source record behind a fact or search result
`outlit_list_sources`	List concrete source records for a customer
`outlit_search_customer_context`	Search grouped source and fact results with natural language

SQL tools are available through @outlit/tools, but they are not enabled by default in @outlit/pi. Use them only for agents that should run read-only SQL.

Minimal Extension

If you only need the Outlit tools and the bundled outlit Pi skill, the package default is enough:

import { createOutlitPiExtension } from "@outlit/pi"

export default createOutlitPiExtension()

The extension reads OUTLIT_API_KEY from the environment and uses https://app.outlit.ai by default.

Custom Toolsets

Pass toolNames when you want a narrower or broader toolset:

import { createOutlitPiExtension, piToolNames } from "@outlit/pi"

export default createOutlitPiExtension({
  toolNames: piToolNames,
})

piToolNames includes SQL and the broader Pi-supported Platform surface. The default membership comes directly from Core’s default consumer policy and contains only the nine read-only customer intelligence tools above; import analyticalToolNames for that same policy plus outlit_schema and outlit_query. The broader Pi policy includes the product-facing Feature list, create, archive, and customer-usage tools. The default and analytical policies remain unchanged.

Growth Agent Examples

The examples/pi-agents package shows four Pi agents built on @outlit/pi for revenue and retention work. It includes:

Outlit customer intelligence, SQL, and schema tools registered in Pi
the generic outlit skill from @outlit/pi
a shared growth-agent skill with evidence-gathering playbooks
a local usage-decay churn pretriage helper with a churn.json config
slash commands and editable prompt templates for usage decay, friction-to-churn, activation failure, and expansion readiness

Try it locally from the SDK repo:

cd examples/pi-agents
npm install
export OUTLIT_API_KEY=ok_your_api_key
pi install -l .
pi

The example package currently uses the canary dist-tag for @outlit/pi and @outlit/tools so fresh installs include the latest public tool contracts before the next stable release is promoted. Then ask:

/outlit-usage-decay-watchtower paying customers over $500 MRR

or:

Which paying customers are active enough to be expansion candidates but blocked by plan limits?

Public Tool Gateway

See the HTTP route and shared @outlit/tools contracts

Agent Skills

Install Outlit guidance for coding agents

Getting Started

Concepts

Browser SDKs

Server SDKs

CLI

AI Integrations

Use Cases

Install

Default Tools

Minimal Extension

Custom Toolsets

Growth Agent Examples

Public Tool Gateway

Agent Skills

​Install

​Default Tools

​Minimal Extension

​Custom Toolsets

​Growth Agent Examples

Public Tool Gateway

Agent Skills

Install

Default Tools

Minimal Extension

Custom Toolsets

Growth Agent Examples