pi-share

Fetch and decode pi-share session exports into structured JSON transcripts.

2.8k|212|Updated Nov 2, 2025
One-click install
npx skills add https://github.com/mitsuhiko/agent-stuff --skill pi-share
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pi-share
Source: https://github.com/mitsuhiko/agent-stuff/tree/main/skills/pi-share
Command: npx skills add https://github.com/mitsuhiko/agent-stuff --skill pi-share

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

pi-share helps you load and parse session transcripts from pi-share style URLs and gists, turning scattered conversation logs into structured data for analysis.

Core Features & Use Cases

  • Transcript retrieval: fetches session exports from shittycodingagent.ai/buildwithpi.ai/buildwithpi.com via gist/session.html.
  • Data decoding: base64-encoded session data is decoded into a usable JSON structure.
  • Conversation extraction: extracts and organizes human-assistant turns for review and research.
  • Human summaries: optional generation of human-centric summaries of sessions.

Quick Start

Use the pi-share skill to fetch and decode a session with a gist ID or URL.

  • Get full session data: node ~/.pi/agent/skills/pi-share/fetch-session.mjs "<gist-id-or-url>"
  • Get just the header: node ~/.pi/agent/skills/pi-share/fetch-session.mjs <gist-id> --header
  • Emit entries as JSON lines: node ~/.pi/agent/skills/pi-share/fetch-session.mjs <gist-id> --entries
  • Generate a human summary: node ~/.pi/agent/skills/pi-share/fetch-session.mjs <gist-id> --human-summary

Frequently Asked Questions about pi-share

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract conversation transcripts from a pi-share session URL?

You can extract conversation transcripts from a pi-share session URL by fetching the session export and decoding the base64-encoded data into a structured JSON format, which organizes the human and assistant turns for review.

Can I generate a human-readable summary from pi session logs?

Yes, you can generate a human-readable summary from pi session logs by using the summary generation feature, which requires the pi CLI to process the extracted conversation turns and output a concise, human-centric overview.

Do I need GitHub gist access to parse pi-share transcripts?

Yes, GitHub gist access is required to parse pi-share transcripts because the session exports are fetched from gist URLs or session.html endpoints to retrieve the base64-encoded conversation data for decoding.

What output formats are available when decoding pi-share session data?

When decoding pi-share session data, available outputs include the full session data as JSON, just the header information, individual conversation entries emitted as JSON lines, or a concise human-centric summary.

How does base64 decoding work for pi-share conversation logs?

Base64 decoding for pi-share conversation logs works by fetching the encoded session data from the gist or session URL and translating it into a usable JSON structure, allowing the extraction of human-assistant dialogue turns.

Are there limitations when fetching session exports from shittycodingagent.ai?

Fetching session exports requires valid gist IDs or URLs from supported domains like shittycodingagent.ai, and generating human summaries specifically requires the pi CLI, meaning the environment must have both GitHub gist access and the CLI installed.