Skip to main content

​
Pi coding agent telemetry

Stream pi coding agent sessions into Latitude as traces with the first-party @latitude-data/pi-telemetry extension. After setup, pi prompts appear in your Latitude project’s Traces view with model calls, prompts, responses, token usage, tool calls, and tool results.

​
Prerequisites

  • A Latitude account with a project
  • A Latitude API key from Settings → API Keys
  • Your Latitude project slug from the project sidebar
  • pi installed locally
  • Node.js available on your PATH

​
Install

Run the installer: 
npx -y @latitude-data/pi-telemetry install
The installer prompts for your API key and project slug, adds the pi extension package to ~/.pi/agent/settings.json, and writes Latitude config to ~/.pi/agent/latitude-telemetry.json. You can also pass values directly: 
npx -y @latitude-data/pi-telemetry install \
  --api-key=lat_xxx \
  --project=your-project-slug \
  --yes

​
Restart and verify

Restart pi so it can install and load the package. Send a prompt that uses the model or a tool, then open your Latitude project and go to Traces. The new trace should appear within a few seconds. A trace includes:
  • an interaction root span for the pi prompt
  • llm_request spans for model calls
  • tool_call:<name> spans for tool executions
  • gen_ai.input.messages and gen_ai.output.messages for prompt/response reconstruction
  • gen_ai.tool.call.arguments and gen_ai.tool.call.result for tool I/O

​
Structural-only telemetry

By default, Latitude receives the content needed to reconstruct pi runs, including prompts, assistant responses, system instructions when available, tool arguments, and tool results. If you want trace structure without conversation or tool content, install with: 
npx -y @latitude-data/pi-telemetry install --no-content
Structural-only traces still include timing, token usage, provider/model names, tool names, session metadata, user/host identity, and whether content capture was enabled.

​
Disable or uninstall

Disable the extension for one pi process: 
LATITUDE_PI_TELEMETRY_ENABLED=0 pi
Remove the extension and config: 
npx -y @latitude-data/pi-telemetry uninstall
Restart pi after uninstalling to unload the extension.

​
Advanced configuration

The installer stores config in ~/.pi/agent/latitude-telemetry.json. Environment variables override file values:
VariableDescription
LATITUDE_API_KEYAPI key used to upload traces
LATITUDE_PROJECT or LATITUDE_PROJECT_SLUGProject slug for X-Latitude-Project
LATITUDE_BASE_URLIngest base URL, default https://ingest.latitude.so
LATITUDE_DEBUG=1Print upload diagnostics
LATITUDE_PI_NO_CONTENT=1Disable prompt/response/tool content capture
LATITUDE_PI_USER_IDOverride user.id
LATITUDE_PI_USER_EMAILOverride user email
LATITUDE_PI_USER_NAMEOverride user display name
LATITUDE_REDACT_ATTRIBUTESJSON array or comma-separated custom attribute patterns to mask before export
LATITUDE_REDACT_MASKMask value for custom redaction, default ******
Use --staging, --dev, or --base-url=<url> during install to target a non-production Latitude ingest endpoint.

​
Captured data and privacy

Full-content mode sends prompts, responses, system instructions when available, tool inputs, and tool outputs. Use --no-content for structural-only telemetry or configure custom redaction as described below. Disable telemetry before working with sensitive material you do not want sent to Latitude. Even --no-content mode still sends structural metadata such as cwd/session identifiers, model names, tool names, timing, token usage, and user/host identity.

​
Custom redaction

If you want to keep content capture enabled but mask specific span attributes before they leave your machine, use redact in ~/.pi/agent/latitude-telemetry.json or the LATITUDE_REDACT_ATTRIBUTES environment variable. Redaction happens locally, after the content gate and before the OTLP export. redact.attributes (or LATITUDE_REDACT_ATTRIBUTES) accepts an array of patterns. Each pattern can be:
  • An exact attribute name — "gen_ai.tool.call.arguments"
  • A regex source string — "^gen_ai\\.(input|output)\\.messages$" (anchored match)
  • A /pattern/flags string — "/^gen_ai\\.tool\\.call\\.(arguments|result)$/i"
redact.mask (or LATITUDE_REDACT_MASK) sets the replacement value (default: ******). Set it to "[]" to replace message arrays with an empty array instead of a string.

​
Via config file

Add a redact block to ~/.pi/agent/latitude-telemetry.json: 
{
  "redact": {
    "attributes": [
      "/^gen_ai\\.(input|output)\\.messages$/",
      "gen_ai.tool.call.arguments",
      "gen_ai.tool.call.result"
    ],
    "mask": "[]"
  }
}

​
Via environment variable

LATITUDE_REDACT_ATTRIBUTES='["/^gen_ai\\.(input|output)\\.messages$/", "gen_ai.tool.call.arguments"]' \
LATITUDE_REDACT_MASK='[]' \
pi

​
Troubleshooting

No traces appear. Restart pi or run /reload, then send a new prompt. Confirm the API key and project slug are correct. HTTP 401. The API key is missing or invalid. Re-run the installer with a valid key. HTTP 400 about X-Latitude-Project. The project slug is missing. Re-run the installer with --project=your-project-slug. Traces show timing but no prompt/response content. Structural-only mode is enabled. Reinstall without --no-content, or set LATITUDE_PI_NO_CONTENT=0 and reload pi. Need diagnostics. Run LATITUDE_DEBUG=1 pi and trigger another prompt.