pine-of-glass

Small observability and context management tools for Pi in the terminal.

1. contextimate breaks down what is filling your context window: sysprompt, AGENTS.md, Skill frontmatter, Tool schemas, and session material. Toggle with ctrl+o on start and /reload.
2. traceline collapses tool calls to one trace line each, so you can see the full arc of what Pi did (path taken, context read, bloated tool results). Toggle with ctrl+t (expands/collapses both thinking blocks and tools).
3. cachemire (experimental) explains cache behaviour and agent-loop economics: a cache TTL clock above the editor, predicted-then-resolved cache-break notices, a per-turn ledger, and /cache forensics. Included in the package as of 0.4.0; wording, thresholds, and states may still evolve.

See each extension's own README.md for details, docs/ for deeper reference, and AGENTS.md for development workflows and conventions.

Installation

• From GitHub: pi install git:github.com/tmustier/pine-of-glass
• From npm (installs contextimate, traceline, and experimental cachemire): pi install npm:pine-of-glass

Screenshots

Traceline

ctrl+t now collapses each tool call and thinking summary to a single line, and you can expand everything back to see per-item details.

Contextimate

Each new session and /reload now lists what's in your context window before you type a word. Toggle level of detail with ctrl+o.

Summary mode:

Compact mode, one aligned line per skill and tool:

Expanded mode, with per-section sources and a schema field tree for every active tool (excerpt):

Cachemire

You now see cache-related warnings inline and a cache shotclock above the editor. /cache gives you a full session review by turn.

Plans

1. The current goal is to provide an interface that makes tool and agent behaviour more legible for humans using pi in their terminal interactively.
2. Once that's solid, we can help both humans and agents to more easily analyse previous sessions and traces, including when pi is running in RPC mode, remotely, or there is a large number of agent sessions we need to read to get insights from.

Note: A nice side benefit of 1. is that tools like traceline can help agents running interactive pi subagents in tmux to monitor them without risking context bloat from tool outputs.

Status: There are several things left to do in 1., including

• maturing cachemire (implemented, live-tested, conformant with the family design language, and now shipped as experimental while the UX settles; see issue #6),
• making contextimate more useful beyond upfront context (for example, are my MCP servers and skills efficient when loaded?)
• and other refinements tracked in issues.