Skip to content

Commit 5cc0927

Browse files
salman1993claude
andcommitted
docs: cover top-level mentions and app-owned Pi in Pi session guide
A session started by a top-level mention records only "Event ID: <id>", so search for that as well as "Thread root: <id>". When Pi was installed through Settings, run the app-owned pi with its bundled Node. Co-Authored-By: Claude Opus 5.5 <[email protected]> Signed-off-by: Salman Mohammed <[email protected]>
1 parent 70e304b commit 5cc0927

1 file changed

Lines changed: 15 additions & 3 deletions

File tree

‎docs/view-pi-session.md‎

Lines changed: 15 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,14 +9,16 @@ title, and sometimes the exact system prompt. The JSONL itself lives under
99

1010
Start from the Buzz link to the thread. In its `buzz://message` link, take the
1111
64-character `thread=` value, or `id=` when the link has no `thread=`. That is
12-
the thread root. Each Buzz turn records `Thread root: <id>` in the Pi
13-
transcript, so search the indexed sessions for it:
12+
the thread root. Turns inside the thread record `Thread root: <id>` in the Pi
13+
transcript. A top-level mention that started the thread records only
14+
`Event ID: <id>`. Search the indexed sessions for either:
1415

1516
```sh
1617
root='<thread-root-id>'
1718
for index in ~/.pi/buzz-pi-acp/sessions/*.json; do
1819
session=$(jq -r '.session.sessionFile' "$index")
19-
if [ -f "$session" ] && rg -q -F "Thread root: $root" "$session"; then
20+
if [ -f "$session" ] &&
21+
rg -q -F -e "Thread root: $root" -e "Event ID: $root" "$session"; then
2022
jq -r --arg index "$index" \
2123
'[.session.updatedAt, .session.sessionTitle // "-", .session.sessionFile, $index] | @tsv' \
2224
"$index"
@@ -37,6 +39,16 @@ pi --export "$session" session.html
3739
open session.html # macOS; otherwise open the file in a browser
3840
```
3941

42+
If `pi` is not on your `PATH` because **Settings → Agents → Install** set up Pi
43+
for Buzz, run Buzz's app-owned copy with its bundled Node:
44+
45+
```sh
46+
app="$HOME/Library/Application Support/dev.local.buzz.foundation"
47+
# Linux: app="${XDG_DATA_HOME:-$HOME/.local/share}/dev.local.buzz.foundation"
48+
PATH="$(echo "$app"/runtimes/node/v24.18.0/*/bin):$PATH" \
49+
"$app/node-tools/bin/pi" --export "$session" session.html
50+
```
51+
4052
The HTML file contains the session conversation and tool activity. Keep it local
4153
unless you intend to share that content.
4254

0 commit comments

Comments
 (0)