@8monkey/pi-session-gzip

This Skill addresses the issue of Pi agent session files consuming significant disk space. In practice, Pi generates numerous JSONL-format session files in the ~/.pi/agent/sessions/ directory, and as the number of sessions grows, disk space is quickly depleted. This Skill automatically compresses the current session's session.jsonl into session.jsonl.gz and deletes the original file each time Pi is closed, allowing idle sessions to be stored in a compressed state while active sessions remain unaffected.

Usage is straightforward: simply install it via pi install npm:@8monkey/pi-session-gzip. After installation, Pi will automatically compress the current session upon exit. To restore a session, tell the AI "resume the last compressed session" or directly run the /resume-compressed command, which will automatically decompress and reopen the corresponding session file. You can also specify a session ID or file path to restore a particular compressed session. The entire process requires no manual intervention and has zero runtime dependencies.

It is ideal for Pi users who need to retain extensive session history over the long term, especially developers or operations personnel who generate a high volume of daily conversations and have limited disk space. For teams that frequently need to review historical sessions but don't want their disks filled with JSONL files, this Skill is an ideal storage optimization solution. It is also suitable for scenarios where the Pi agent runs on resource-constrained servers.

It is recommended to test the compression/restoration process once immediately after installation to ensure it works correctly. Note that compression is triggered only when Pi exits normally; it will not occur if the process is forcibly terminated. The restore operation is idempotent, and repeated execution will not cause side effects. Additionally, empty sessions and sessions in --no-session mode are automatically skipped and will not generate compressed files.