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 read-only:

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,
})

Use the default policy for nine read-only customer tools. Use analyticalToolNames when the agent also needs outlit_schema and read-only outlit_query (11 tools total). piToolNames is broader: it includes SQL, customer relationship and Attention reads, customer ownership and access actions, Feature tools, workspace configuration, and outlit_submit_feedback for product feedback intake. Choose the smallest set your Pi agent needs.

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

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

Agents

CLI

Concepts

Outlit SDKs

Examples

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