pi-share_skill

Overview

This skill loads and parses session transcripts exported from pi-share URLs (shittycodingagent.ai / buildwithpi.ai / buildwithpi.com). It fetches the underlying GitHub Gist, decodes the embedded session HTML, and extracts the conversation history and metadata. Use it to inspect full sessions, get compact JSON entries, or produce human-focused summaries of the user’s behavior.

How this skill works

The script locates a gist ID in the provided URL or accepts a raw gist ID. It fetches the gist, finds the session.html file, and base64-decodes the embedded session payload. The decoded data is parsed into a SessionData structure with header, entries, system prompt, tools, and leafId. Flags let you output the header, entries (JSON lines), system prompt, tool list, or a human-centric summary.

When to use it

• You have a pi-share/session URL or gist ID and need the full conversation transcript.
• You want structured JSON entries for programmatic analysis or jq filtering.
• You need the system prompt or tool definitions used in a session.
• You want a human-centric summary focusing on what the user did and how they steered the agent.
• You want to count tool calls, find user messages, or inspect model/thinking changes.

Best practices

• Provide the full session URL or just the gist ID to avoid parsing errors.
• Use --entries for machine processing and piping into jq or other tools.
• Use --header to quickly see session metadata (timestamp, session id, cwd).
• Run --human-summary when you need a concise, human-focused narrative of the user’s behavior.
• Validate network access to GitHub API if gists are private or rate-limited.

Example use cases

• Load a session and filter to user messages: fetch-session.mjs <id> --entries | jq 'select(.type=="message" and .message.role=="user")'
• Generate a human-centric summary to understand how a user iterated on prompts: fetch-session.mjs <id> --human-summary
• Extract system prompt and tools to reproduce the agent environment: fetch-session.mjs <id> --system --tools