pi-context

Live context-window tracker for pi. Shows how much of the active model's context is in use, breaks it down by category (messages, system prompt, tools, skills, MCP, bundles), and supports cross-model handoff when you switch providers mid-session.

Version 0.3.7 — Pack name tab-completion for import/export/handoff; scans global, project, and extension pack dirs.

Install

pi install npm:@zaganjade/pi-context
/reload

Local development:

pi install ./Pi-Context
/reload

Commands

| Command | Description | |---------|-------------| | /context | Open context panel (compact) — Tab expand, e export, i import, h handoff | | /context all | Expanded view with child rows | | /context-export [name] | Save Context Pack to ~/.pi/agent/context-packs/ | | /context-import <name> | Scale + inject pack for current model (tab-complete from pack history) | | /context-handoff [name] | Export pack + prompt to switch model (tab-complete names) | | /context-widget | Toggle always-on context line | | /context-config | Warn threshold + handoff reserve percent |

Cross-model handoff (GLM → GPT)

# 1. Brainstorm with GLM
/context-handoff glm-brainstorm

# 2. Switch model in pi (e.g. to GPT)

# 3. Import shared context
/context-import glm-brainstorm

Pi-Context injects a native Pi <skill name="pi-context-handoff" location="…"> block — the same envelope /skill:name uses. The TUI shows [skill] pi-context-handoff (Ctrl+O to expand) instead of dumping the full handoff. If the target model has a smaller context window, older messages are dropped and omissions are reported.

Pack discovery: Tab-complete on /context-import, /context-export, and /context-handoff scans ~/.pi/agent/context-packs/, {project}/.pi/context-packs/, {project}/context-packs/, and the extension context-packs/ folder. Project packs for the current cwd are ranked first.

Categories tracked

| Category | Source | |----------|--------| | Messages | Session branch (estimateTokens) | | System prompt | ctx.getSystemPrompt() | | System tools | Active tool schemas | | Skills | before_agent_start system prompt options | | MCP tools | Active MCP-registered tools | | MCP (deferred) | Inactive MCP tool schemas | | Slash commands | Extension commands | | Memory files | Project context files | | Custom agents | pi-subagents detection | | Bundles | @bundle from pi-multi-skill activations | | Free space | contextWindow - used |

Total aligns with pi's native ctx.getContextUsage() when available. After compaction, total shows ? until the next model response (same as pi footer).

Accounting model: The header total counts only messages + system prompt + memory files (non-overlapping). Rows like System tools, Skills, and MCP are an illustrative breakdown of what lives inside the system prompt — they are scaled to fit within that bucket and do not add to the header total separately.

Configuration

~/.pi/agent/context.json (auto-created):

{
  "showWidget": false,
  "warnPercent": 70,
  "reservePercent": 15,
  "autoSuggestHandoff": true
}

License

MIT — see LICENSE.