Manage Pi session state with branch-aware reconstruction and compaction interception.
npx skills add https://github.com/dotBeeps/hoard --skill pi-sessions
Please help me install this Agent Skill. Skill: pi-sessions Source: https://github.com/dotBeeps/hoard/tree/main/morsels/skills/pi-sessions Command: npx skills add https://github.com/dotBeeps/hoard --skill pi-sessions
Pi-sessions ensures extensions preserve and reconstruct state correctly across branching, forks, and compaction in Pi sessions, preventing state divergence and stale UI or data when the conversation tree changes.
Use pi-sessions to reconstruct extension state after a session switch by scanning the branch for toolResult and custom entries and then initialize your UI from the resulting snapshot.
High-intent search queries and answers about installing and using this skill.
To restore extension state after a Pi session branches or forks, perform event-driven reconstruction by scanning the current session branch for toolResult and custom entries to rebuild in-memory state and prevent state divergence.
Pi session compaction interception works by allowing extensions to intercept, cancel, or replace automatic compaction summaries, enabling proactive compaction to protect important context during the session lifecycle.
Yes, you can persist extension UI preferences or bookmarks without polluting LLM context by using custom, non-LLM-visible entries that keep state in the session tree safely.
The best way to manage state lifecycle hooks in Pi conversation trees is applying event-driven reconstruction and compaction interception compatible with Pi's session APIs to ensure consistent state across branching.
Extensions show stale UI data after automatic compaction because state is not properly reconstructed; scanning the session branch for custom entries on compaction events restores the correct snapshot.
Yes, pi-sessions supports branch-safe state reconstruction for stateful panel extensions by reliably restoring lists, preferences, and bookmarks after users navigate branches, fork sessions, or trigger automatic compaction.
TrebuchetDynamicsGuide documentation-first implementation and extension shape selection for Pi extensions.
joshka0Restore saved session state after compaction using FOXCTL_SESSION_RESTORED.
ruskibeatsAnalyze Pi extension structure, entry points, and components.
iia-argAdd a /compact slash command to trigger session compaction via the Claude SDK.
