pi-session-reader - SKILL.md Agent Skill

name: pi-session-reader description: Read Pi agent sessions to monitor what other agents are doing, check their status (busy/idle), and understand their conversation history.

Pi Session Reader

Monitor Pi agents by reading their session files.

Session Location

~/.pi/agent/sessions/--<path-with-dashes>--/<timestamp>_<uuid>.jsonl

Find Latest Session for a Project

# Screenpipe
ls -t ~/.pi/agent/sessions/--Users-louisbeaumont-Documents-screenpipe--/*.jsonl | head -1

# Brain
ls -t ~/.pi/agent/sessions/--Users-louisbeaumont-Documents-brain--/*.jsonl | head -1

# Generic pattern
ls -t ~/.pi/agent/sessions/--Users-louisbeaumont-Documents-<project>--/*.jsonl | head -1

Check Agent Status (Busy or Idle)

SESSION=$(ls -t ~/.pi/agent/sessions/--Users-louisbeaumont-Documents-screenpipe--/*.jsonl | head -1)
tail -1 "$SESSION" | jq '{role: .message.role, stopReason: .message.stopReason}'

stopReason: "stop" + role: "assistant" = Idle (ready for new task)
role: "toolResult" or stopReason: null = Busy (still working)

Read Recent Conversation

SESSION=$(ls -t ~/.pi/agent/sessions/--Users-louisbeaumont-Documents-screenpipe--/*.jsonl | head -1)
tail -30 "$SESSION" | jq -r 'select(.type=="message") | "\(.message.role): \(.message.content | if type=="array" then (.[0].text // .[0].type) else . end | tostring | .[0:150])"'

Get Last User Prompt

tail -100 "$SESSION" | jq -r 'select(.type=="message" and .message.role=="user") | .message.content' | tail -1

Monitor All Active Sessions

for dir in ~/.pi/agent/sessions/--Users-louisbeaumont-Documents-*; do
  PROJECT=$(basename "$dir" | sed 's/--Users-louisbeaumont-Documents-//' | sed 's/--$//')
  SESSION=$(ls -t "$dir"/*.jsonl 2>/dev/null | head -1)
  if [ -n "$SESSION" ]; then
    STATUS=$(tail -1 "$SESSION" | jq -r '.message.stopReason // "working"')
    echo "$PROJECT: $STATUS"
  fi
done

Full Agent Status Dashboard

echo "=== Pi Agent Status ==="
for dir in ~/.pi/agent/sessions/--Users-louisbeaumont-Documents-*; do
  PROJECT=$(basename "$dir" | sed 's/--Users-louisbeaumont-Documents-//' | sed 's/--$//')
  SESSION=$(ls -t "$dir"/*.jsonl 2>/dev/null | head -1)
  if [ -n "$SESSION" ]; then
    LAST=$(tail -1 "$SESSION" | jq -r '{role: .message.role, stop: .message.stopReason}')
    ROLE=$(echo "$LAST" | jq -r '.role')
    STOP=$(echo "$LAST" | jq -r '.stop')
    if [ "$STOP" = "stop" ] && [ "$ROLE" = "assistant" ]; then
      STATUS="✅ Idle"
    else
      STATUS="🔄 Working"
    fi
    TASK=$(tail -50 "$SESSION" | jq -r 'select(.type=="message" and .message.role=="user") | .message.content | if type=="array" then .[0].text else . end' 2>/dev/null | tail -1 | head -c 60)
    echo "$PROJECT: $STATUS - $TASK..."
  fi
done

Session Format Reference

Each line is JSON:

type: "session" - Header
type: "message" - Conversation (role: user/assistant/toolResult)
type: "compaction" - Context was summarized

Message structure:

{"type":"message","message":{"role":"user","content":"hello"}}
{"type":"message","message":{"role":"assistant","content":[{"type":"text","text":"Hi!"}],"stopReason":"stop"}}
{"type":"message","message":{"role":"toolResult","toolName":"bash","content":[{"type":"text","text":"output"}]}}