observal-pi

Observal session telemetry for Pi — zero-dependency extension that pushes session traces to your Observal server

Package details

extension

Install observal-pi from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:observal-pi

Pi manifest JSON

{
  "extensions": [
    "./extensions/observal.ts"
  ]
}

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

Session telemetry extension for Pi that pushes conversation traces to your Observal server.

pi install npm:observal-pi

Incremental push: After each user prompt (agent_end), reads new JSONL lines from the session file and POSTs them to your Observal server
Final push: On session exit, sends remaining lines with integrity metadata
Crash recovery: On startup, detects sessions that weren't cleanly finalized and pushes their remaining data
Status indicator: Shows ● observal in the footer with line count

Command	Description
`/obs-sync`	Show sync status (lines pushed, server URL)
`/obs-sync flush`	Force push pending lines now
`/obs-sync config`	Show config file path and server URL

Zero dependencies — only node:* built-ins
Fail-open — never throws, never crashes pi. If the server is unreachable, pi continues normally
5s timeout — all HTTP calls abort after 5 seconds
Chunked uploads — batches of 500 lines max per request
Dedup-safe — server deduplicates by (session_id, line_offset, line_hash)

The extension reads credentials from ~/.observal/config.json (written by observal auth login):

{
  "server_url": "https://your-server.observal.dev",
  "access_token": "..."
}

Sync state is tracked in ~/.observal/sync_state.json (per-session byte offsets).

AGPL-3.0-only — see LICENSE