pi-content-offloader

Offloads user content in pi to a temporary directory (<tmpdir>/pi-offloads/).

Modes

Stable mode (default) — only offloads content explicitly wrapped between markers:

$offload build-logs

app.js     123.4 kB  gzip  45.2 kB
about.js    12.3 kB  gzip   4.1 kB
dashboard.js  89.0 kB  gzip  28.3 kB

$/offload

Why is the dashboard chunk so large?

Everything between $offload and $/offload is offloaded to a file. A summary replaces it in the chat. Your question after $/offload stays in the conversation.

Auto-detect mode (opt-in) — pasted content matching log/output patterns is automatically detected and offloaded. Enable by setting the environment variable in your shell before launching pi:

export PI_OFFLOADER_AUTO_DETECT=true

Or in your pi config (~/.pi/config.toml):

[env]
PI_OFFLOADER_AUTO_DETECT = "true"

Or toggle at runtime with /offloader-toggle.

[2026-06-04 14:32:01] ERROR: Connection timeout on /api/users
[2026-06-04 14:32:02] ERROR: Retry failed (1/3)
[2026-06-04 14:32:03] ERROR: Retry failed (2/3)
[2026-06-04 14:32:04] ERROR: Retry failed (3/3)
[2026-06-04 14:32:05] FATAL: Connection pool exhausted


Can you investigate this timeout issue?

Content matching log/output patterns (>2KB) or anything >8KB is offloaded automatically. The question after the blank lines stays in the chat.

Features

• Explicit markers: $offload [name] starts a block, $/offload ends it. Everything between is offloaded. No accidental offloads.
• Fallback without $/offload: Content ends at a double blank line with conversational text after it, or at the next $offload marker.
• Smart previews: Shows a concise summary (error first/last lines, build chunk stats, table rows) instead of the raw dump. Content is classified as: log output, stack trace, build output, config dump, table, or generic content.
• Suffix extraction: Your question (after $/offload or a double blank line) stays in the chat while the data is offloaded.
• Deduplication: Content hashes prevent duplicate offloads.
• Auto-cleanup: Files older than 7 days are removed automatically on session start.

Install

pi install npm:pi-content-offloader

Or from a local path:

pi install ./extensions/content-offloader

Configuration

| Setting | Default | Description | |---|---|---| | PI_OFFLOADER_AUTO_DETECT | false | Set to true to enable auto-detect paste offloading | | /offloader-toggle | — | Toggle auto-detect on/off at runtime |

Development

bun install        # install dev dependencies
bun test           # run tests
bun typecheck      # type-check with tsc
bun lint           # lint with biome

License

MIT